booths 1.0.0 → 1.2.0

package/dist/index.d.ts

@@ -191,6 +191,15 @@ export declare class BoothPluginRegistry {
      * @returns The plugin instance if found, undefined otherwise
      */
     getPluginById(pluginId: string): BoothPlugin | undefined;
+    /**
+     * Finds and returns multiple plugins by their IDs.
+     * Throws an error if any plugin ID is not found.
+     *
+     * @param pluginIds - Array of unique identifiers of the plugins to retrieve
+     * @returns Array of plugin instances
+     * @throws Error if any plugin ID is not registered
+     */
+    getPluginsByIds(pluginIds: string[]): BoothPlugin[];
     /**
      * Removes a plugin from the registry by its ID.
      * Throws an error if the plugin doesn't exist.
@@ -305,6 +314,23 @@ export declare class BoothRegistry {
      * @private
      */
     private currentContextId;
+    /**
+     * Tracks whether the orchestrator booth is currently registered.
+     * @private
+     */
+    private hasOrchestrator;
+    /**
+     * Optional callback function that gets called when multi-booth mode is enabled.
+     * Used to coordinate external actions like tool registration.
+     * @private
+     */
+    private onMultiBoothModeEnabled?;
+    /**
+     * Optional callback function that gets called when multi-booth mode is disabled.
+     * Used to coordinate external actions like tool unregistration.
+     * @private
+     */
+    private onMultiBoothModeDisabled?;
     /**
      * Creates a new booth registry with a specified base booth configuration.
      *
@@ -367,6 +393,15 @@ export declare class BoothRegistry {
      * @returns The booth configuration if found, undefined otherwise
      */
     getBoothById(boothId: string): BoothConfig | undefined;
+    /**
+     * Finds and returns multiple booth configurations by their IDs.
+     * Throws an error if any booth ID is not found.
+     *
+     * @param boothIds - Array of unique identifiers of the booths to retrieve
+     * @returns Array of booth configurations
+     * @throws Error if any booth ID is not registered
+     */
+    getBoothsByIds(boothIds: string[]): BoothConfig[];
     /**
      * Returns all registered booth configurations.
      *
@@ -375,9 +410,23 @@ export declare class BoothRegistry {
     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`.
+     * Enables multi-booth mode by registering the orchestrator and setting it as current context.
+     * @private
+     */
+    private enableMultiBoothMode;
+    /**
+     * Disables multi-booth mode by unregistering the orchestrator and resetting context to base booth.
+     * @private
      */
+    private disableMultiBoothMode;
+    /**
+     * Sets callback functions for when multi-booth mode is enabled/disabled.
+     * Used to coordinate external actions like tool registration/unregistration.
+     *
+     * @param onEnabled - Callback for when multi-booth mode is enabled
+     * @param onDisabled - Callback for when multi-booth mode is disabled
+     */
+    setMultiBoothModeCallbacks(onEnabled?: () => void, onDisabled?: () => void): void;
     get isMultiBoothMode(): boolean;
     /**
      * Removes a booth configuration from the registry by its ID.
@@ -388,6 +437,12 @@ export declare class BoothRegistry {
     unregisterBooth(boothId: string): void;
 }
 
+export declare type BoothResponseInput = BoothResponseInputItem[];
+
+export declare type BoothResponseInputItem = (ResponseInputItem & {
+    bmId: string;
+}) | string;
+
 /**
  * The ContextProviderPlugin provides contextual information to booths during interaction loops.
  *
@@ -480,12 +535,19 @@ export declare class ConversationHistoryPlugin implements BoothPlugin {
      */
     private responseContainsBoothChange;
     /**
-     * Constructs a new instance with the provided session history.
+     * Constructs a new instance with an optional session history.
      *
-     * @param {ResponseInput} [sessionHistory=[]] - An optional array representing the session history. Defaults to an empty array if not provided.
-     * @return {void}
+     * @param {ResponseInput[]} [sessionHistory=[]] - An array representing the session history. Defaults to an empty array if not provided.
      */
     constructor(sessionHistory?: ResponseInput);
+    /**
+     * Retrieves the session history.
+     *
+     * @return {Array} The history of the current session.
+     */
+    get history(): (ResponseInputItem & {
+        bmId?: string;
+    })[];
     /**
      * Returns the plugin's unique identifier.
      */
@@ -517,7 +579,7 @@ export declare class ConversationHistoryPlugin implements BoothPlugin {
      * @returns Unmodified response parameters
      */
     onResponseReceived(utilities: RepositoryUtilities, responseParams: ResponseCreateParamsNonStreaming, response: Response_2): Promise<{
-        input: ( ResponseFunctionToolCall | EasyInputMessage | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseInputItem.ComputerCallOutput | ResponseFunctionWebSearch | ResponseInputItem.FunctionCallOutput | ResponseReasoningItem | ResponseInputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseInputItem.LocalShellCall | ResponseInputItem.LocalShellCallOutput | ResponseInputItem.McpListTools | ResponseInputItem.McpApprovalRequest | ResponseInputItem.McpApprovalResponse | ResponseInputItem.McpCall | ResponseInputItem.ItemReference)[];
+        input: ( EasyInputMessage | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseInputItem.ComputerCallOutput | ResponseFunctionWebSearch | ResponseFunctionToolCall | ResponseInputItem.FunctionCallOutput | ResponseReasoningItem | ResponseInputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseInputItem.LocalShellCall | ResponseInputItem.LocalShellCallOutput | ResponseInputItem.McpListTools | ResponseInputItem.McpApprovalRequest | ResponseInputItem.McpApprovalResponse | ResponseInputItem.McpCall | ResponseInputItem.ItemReference)[];
         stream?: false | null;
         background?: boolean | null;
         include?: Array< ResponseIncludable> | null;
@@ -942,6 +1004,15 @@ export declare class ToolRegistry {
      * @returns The tool instance if found, undefined otherwise
      */
     getTool(toolName: string): ToolModule;
+    /**
+     * Finds and returns multiple tools by their names.
+     * Throws an error if any tool name is not found (via getTool method).
+     *
+     * @param toolNames - Array of unique names of the tools to retrieve
+     * @returns Array of tool instances
+     * @throws Error if any tool name is not registered
+     */
+    getToolsByNames(toolNames: string[]): ToolModule[];
     getGlobalTools(): ToolModule[];
     /**
      * Returns all registered tools as an array.

package/dist/index.js

@@ -1,14 +1,9 @@
-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
-     */
-    n(this, "plugins", []);
-  }
+class p {
+  /**
+   * Collection of registered plugins.
+   * @private
+   */
+  plugins = [];
   /**
    * Registers a single plugin in the registry.
    * Throws an error if a plugin with the same ID already exists.
@@ -46,6 +41,24 @@ class d {
   getPluginById(t) {
     return this.plugins.find((o) => o.id === t);
   }
+  /**
+   * Finds and returns multiple plugins by their IDs.
+   * Throws an error if any plugin ID is not found.
+   *
+   * @param pluginIds - Array of unique identifiers of the plugins to retrieve
+   * @returns Array of plugin instances
+   * @throws Error if any plugin ID is not registered
+   */
+  getPluginsByIds(t) {
+    const o = [];
+    for (const e of t) {
+      const r = this.getPluginById(e);
+      if (!r)
+        throw new Error(`Plugin with ID ${e} is not registered.`);
+      o.push(r);
+    }
+    return o;
+  }
   /**
    * Removes a plugin from the registry by its ID.
    * Throws an error if the plugin doesn't exist.
@@ -167,8 +180,8 @@ class d {
    */
   async runAfterToolCall(t, o, e, r) {
     let s = e;
-    for (const a of this.plugins)
-      a.onAfterToolCall && (s = await a.onAfterToolCall(t, o, s, r));
+    for (const l of this.plugins)
+      l.onAfterToolCall && (s = await l.onAfterToolCall(t, o, s, r));
     return s;
   }
   /**
@@ -184,12 +197,47 @@ class d {
    */
   async runToolCallError(t, o, e, r) {
     let s = `Error: ${e.message}`;
-    for (const a of this.plugins)
-      a.onToolCallError && (s = await a.onToolCallError(t, o, e, r));
+    for (const l of this.plugins)
+      l.onToolCallError && (s = await l.onToolCallError(t, o, e, r));
     return s;
   }
 }
-class v {
+const u = {
+  id: "orchestrator",
+  role: `
+    This booth serves as the orchestration layer that analyzes user intent and routes
+    conversations to the most appropriate specialized booth configuration.
+  `,
+  description: `
+    You are the orchestration layer responsible for determining which booth configuration
+    should be active based on user needs. Focus exclusively on routing - do not answer
+    questions or provide information directly to users.
+
+    [ROUTING STRATEGY]
+    - Analyze user request and route to the most appropriate specialized booth immediately
+    - This booth is only active for initial routing or when explicitly routed back to
+    - Once routed, the target booth handles the conversation until completion or re-routing
+
+    [ROUTING TARGETS]
+    - Ambiguous requests → Ask for clarification, then route appropriately
+
+    [CORE PRINCIPLES]
+    - Maintain illusion of single, continuous assistant
+    - Never reference booths, tools, or system mechanics to users
+    - Silent routing is preferred when intent is clear
+    - Only speak to users when clarification is absolutely necessary
+
+    [ROUTING BEHAVIOR]
+    - Clear intent: Route silently using route_to_booth() - do NOT respond to user
+    - Ambiguous intent: Ask user for clarification, then route once clarified
+    - Never respond to user AND route - it's either respond OR route, not both
+
+    [BEHAVIOR EXAMPLES]
+    - User: "How do I test my number?" → route_to_booth({ targetBooth: 'page-router-booth' })
+    - User: "I need help" → "What specifically would you like help with?" → then route based on response
+  `
+};
+class R {
   /**
    * Creates a new booth registry with a specified base booth configuration.
    *
@@ -197,18 +245,35 @@ class v {
    * @param currentContextId - The initial current context booth ID (default is 'orchestrator')
    */
   constructor(t, o) {
-    /**
-     * Collection of registered booth configurations, indexed by their IDs.
-     * @private
-     */
-    n(this, "booths", {});
-    /**
-     * The current context booth ID, defaulting to the orchestrator context.
-     * @private
-     */
-    n(this, "currentContextId");
     this.baseBooth = t, this.registerBooth(t), this.currentContextId = o || t.id;
   }
+  /**
+   * Collection of registered booth configurations, indexed by their IDs.
+   * @private
+   */
+  booths = {};
+  /**
+   * The current context booth ID, defaulting to the orchestrator context.
+   * @private
+   */
+  currentContextId;
+  /**
+   * Tracks whether the orchestrator booth is currently registered.
+   * @private
+   */
+  hasOrchestrator = !1;
+  /**
+   * Optional callback function that gets called when multi-booth mode is enabled.
+   * Used to coordinate external actions like tool registration.
+   * @private
+   */
+  onMultiBoothModeEnabled;
+  /**
+   * Optional callback function that gets called when multi-booth mode is disabled.
+   * Used to coordinate external actions like tool unregistration.
+   * @private
+   */
+  onMultiBoothModeDisabled;
   /**
    * Gets the current context booth ID.
    *
@@ -247,7 +312,11 @@ class v {
    * @param boothConfig - The booth configuration to register
    */
   registerBooth(t) {
-    this.booths[t.id] || (this.booths[t.id] = t);
+    if (this.booths[t.id])
+      return;
+    this.booths[t.id] = t, Object.keys(this.booths).filter(
+      (e) => e !== u.id
+    ).length > 1 && !this.hasOrchestrator && this.enableMultiBoothMode();
   }
   /**
    * Returns the base booth configuration that was provided during initialization.
@@ -289,6 +358,24 @@ class v {
   getBoothById(t) {
     return this.booths[t];
   }
+  /**
+   * Finds and returns multiple booth configurations by their IDs.
+   * Throws an error if any booth ID is not found.
+   *
+   * @param boothIds - Array of unique identifiers of the booths to retrieve
+   * @returns Array of booth configurations
+   * @throws Error if any booth ID is not registered
+   */
+  getBoothsByIds(t) {
+    const o = [];
+    for (const e of t) {
+      const r = this.getBoothById(e);
+      if (!r)
+        throw new Error(`Booth with ID ${e} is not registered.`);
+      o.push(r);
+    }
+    return o;
+  }
   /**
    * Returns all registered booth configurations.
    *
@@ -301,11 +388,33 @@ class v {
     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`.
+   * Enables multi-booth mode by registering the orchestrator and setting it as current context.
+   * @private
+   */
+  enableMultiBoothMode() {
+    this.hasOrchestrator || (this.booths[u.id] = u, this.hasOrchestrator = !0, this.currentContextId = u.id, this.onMultiBoothModeEnabled?.());
+  }
+  /**
+   * Disables multi-booth mode by unregistering the orchestrator and resetting context to base booth.
+   * @private
+   */
+  disableMultiBoothMode() {
+    this.hasOrchestrator && (delete this.booths[u.id], this.hasOrchestrator = !1, this.currentContextId = this.baseBooth.id, this.onMultiBoothModeDisabled?.());
+  }
+  /**
+   * Sets callback functions for when multi-booth mode is enabled/disabled.
+   * Used to coordinate external actions like tool registration/unregistration.
+   *
+   * @param onEnabled - Callback for when multi-booth mode is enabled
+   * @param onDisabled - Callback for when multi-booth mode is disabled
    */
+  setMultiBoothModeCallbacks(t, o) {
+    this.onMultiBoothModeEnabled = t, this.onMultiBoothModeDisabled = o;
+  }
   get isMultiBoothMode() {
-    return Object.keys(this.booths).length > 1;
+    return Object.keys(this.booths).filter(
+      (o) => o !== u.id
+    ).length > 1;
   }
   /**
    * Removes a booth configuration from the registry by its ID.
@@ -316,10 +425,16 @@ class v {
   unregisterBooth(t) {
     if (!this.booths[t])
       throw new Error(`Booth with ID ${t} does not exist.`);
-    delete this.booths[t];
+    if (t === u.id)
+      throw new Error(
+        "Cannot unregister orchestrator booth directly. It will be automatically managed based on booth count."
+      );
+    delete this.booths[t], Object.keys(this.booths).filter(
+      (e) => e !== u.id
+    ).length <= 1 && this.hasOrchestrator && this.disableMultiBoothMode();
   }
 }
-class E {
+class B {
   /**
    * Creates an instance of InteractionProcessor.
    * @param boothRegistry - The registry for booth configurations.
@@ -328,9 +443,9 @@ class E {
    * @param llmAdapter - The adapter for interacting with the LLM.
    */
   constructor(t, o, e, r) {
-    n(this, "loopLimit", 10);
     this.boothRegistry = t, this.boothPlugins = o, this.toolRegistry = e, this.llmAdapter = r;
   }
+  loopLimit = 10;
   /**
    * Creates a synthetic error response with proper structure and error details.
    * @param error - The error that occurred
@@ -473,13 +588,13 @@ class E {
     ), r;
   }
 }
-const C = {
+const T = {
   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."
-}, p = "route_to_booth";
-function w(i) {
-  const t = i.getAllBooths(), o = Object.values(t).map(
+}, f = "route_to_booth";
+function y(n) {
+  const t = n.getAllBooths(), o = Object.values(t).map(
     (r) => `- ${r.id}: ${r.role}
   Examples:
 ${(r.examples || []).map((s) => `    - "${s}"`).join(`
@@ -488,7 +603,7 @@ ${(r.examples || []).map((s) => `    - "${s}"`).join(`
 `), e = Object.keys(t);
   return {
     type: "function",
-    name: p,
+    name: f,
     description: `
     Routes the conversation to a specialized booth based on the user's needs. Each booth has a 
     specific role and set of capabilities.
@@ -518,7 +633,7 @@ ${o}
      */
     execute: async function({ targetBooth: r }) {
       try {
-        return i.setCurrentContextId(r), {
+        return n.setCurrentContextId(r), {
           content: `Routed to booth ${r}`
         };
       } catch (s) {
@@ -529,36 +644,27 @@ ${o}
     }
   };
 }
-class I {
+class v {
   /**
-   * 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}
+   * 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.
    */
-  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
-     */
-    n(this, "plugin_id", "conversation-history");
-    /**
-     * Display name for this plugin.
-     * @private
-     */
-    n(this, "plugin_name", "Conversation History Plugin");
-    /**
-     * Brief description of the plugin's purpose and functionality.
-     * @private
-     */
-    n(this, "plugin_description", "A plugin to manage conversation history in booths.");
-    this.sessionHistory = t;
-  }
+  sessionHistory = [];
+  /**
+   * Unique identifier for this plugin instance.
+   * @private
+   */
+  plugin_id = "conversation-history";
+  /**
+   * Display name for this plugin.
+   * @private
+   */
+  plugin_name = "Conversation History Plugin";
+  /**
+   * Brief description of the plugin's purpose and functionality.
+   * @private
+   */
+  plugin_description = "A plugin to manage conversation history in booths.";
   /**
    * Checks if the given response contains a booth change.
    *
@@ -569,10 +675,26 @@ class I {
    * @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 === 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
+    return t.output ? t.output.some((o) => o.type === "function_call" ? o.name === f : o.type === "message" && "tool_calls" in o && Array.isArray(o.tool_calls) ? o.tool_calls.some(
+      (e) => e.type === "function" && e.function.name === f
     ) : !1) : !1;
   }
+  /**
+   * Constructs a new instance with an optional session history.
+   *
+   * @param {ResponseInput[]} [sessionHistory=[]] - An array representing the session history. Defaults to an empty array if not provided.
+   */
+  constructor(t = []) {
+    this.sessionHistory = t;
+  }
+  /**
+   * Retrieves the session history.
+   *
+   * @return {Array} The history of the current session.
+   */
+  get history() {
+    return this.sessionHistory;
+  }
   /**
    * Returns the plugin's unique identifier.
    */
@@ -616,17 +738,15 @@ class I {
    * @returns Unmodified response parameters
    */
   async onResponseReceived(t, o, e) {
-    let s = [...o.input, ...(e == null ? void 0 : e.output) ?? []];
+    let s = [...o.input, ...e?.output ?? []];
     if (this.responseContainsBoothChange(e)) {
-      const l = `Please summarize the following conversation history:
+      const i = `Please summarize the following conversation history:
 
-${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 = {
+${JSON.stringify(this.sessionHistory)}`, d = (await P(t.llmAdapter, T).callProcessor.send(i)).output_text, g = s.filter((h) => "role" in h && h.role === "user").pop(), b = {
         role: "developer",
-        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"
-      );
-      this.sessionHistory = f ? [...b, m, f] : [...b, m], s = this.sessionHistory;
+        content: `A conversation summary up to this point: ${d}`
+      }, w = s.filter((h) => !("role" in h && h.role === "user" || "type" in h && h.type === "message"));
+      this.sessionHistory = g ? [...w, b, g] : [...w, b], s = this.sessionHistory;
     } else
       this.sessionHistory = s;
     return {
@@ -644,24 +764,22 @@ ${JSON.stringify(this.sessionHistory)}`, c = (await L(t.llmAdapter, C).callProce
     return !1;
   }
 }
-class A {
-  constructor() {
-    /**
-     * Unique identifier for this plugin instance.
-     * @private
-     */
-    n(this, "plugin_id", "context-provider");
-    /**
-     * Display the name for this plugin.
-     * @private
-     */
-    n(this, "plugin_name", "Context Provider Plugin");
-    /**
-     * Brief description of the plugin's purpose and functionality.
-     * @private
-     */
-    n(this, "plugin_description", "A plugin to provide context to booths.");
-  }
+class E {
+  /**
+   * Unique identifier for this plugin instance.
+   * @private
+   */
+  plugin_id = "context-provider";
+  /**
+   * Display the name for this plugin.
+   * @private
+   */
+  plugin_name = "Context Provider Plugin";
+  /**
+   * Brief description of the plugin's purpose and functionality.
+   * @private
+   */
+  plugin_description = "A plugin to provide context to booths.";
   /**
    * Returns the plugin's unique identifier.
    */
@@ -692,12 +810,12 @@ class A {
     const e = t.boothRegistry;
     let s = e.baseBoothConfig.description;
     if (e.isMultiBoothMode) {
-      const a = e.orchestratorBoothConfig, l = e.currentContextBoothConfig;
+      const l = e.orchestratorBoothConfig, i = e.currentContextBoothConfig;
       s += `
 
- ${a.description}`, l.id !== a.id && (s += `
+ ${l.description}`, i.id !== l.id && (s += `
 
- ${l.description}`);
+ ${i.description}`);
     }
     return { ...o, instructions: s };
   }
@@ -712,11 +830,11 @@ class A {
   }
 }
 class _ {
+  tools;
   /**
    * Initializes an empty Map to store tools.
    */
   constructor() {
-    n(this, "tools");
     this.tools = /* @__PURE__ */ new Map();
   }
   registerTools(t) {
@@ -749,6 +867,22 @@ class _ {
       throw new Error(`Tool with name ${t} is not registered.`);
     return o;
   }
+  /**
+   * Finds and returns multiple tools by their names.
+   * Throws an error if any tool name is not found (via getTool method).
+   *
+   * @param toolNames - Array of unique names of the tools to retrieve
+   * @returns Array of tool instances
+   * @throws Error if any tool name is not registered
+   */
+  getToolsByNames(t) {
+    const o = [];
+    for (const e of t) {
+      const r = this.getTool(e);
+      o.push(r);
+    }
+    return o;
+  }
   getGlobalTools() {
     return Array.from(this.tools.values()).filter((t) => t.global);
   }
@@ -791,12 +925,41 @@ class _ {
     this.tools.delete(t);
   }
 }
-class x {
-  constructor() {
-    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");
+function I(n) {
+  switch (n.type) {
+    case "function":
+      return `function:${n.name}`;
+    case "mcp":
+      return `mcp:${n.server_label}`;
+    case "file_search":
+      return `file_search:${n.vector_store_ids.join(",")}`;
+    case "web_search_preview":
+    case "web_search_preview_2025_03_11":
+      return `web_search:${n.type}`;
+    case "computer_use_preview":
+      return `computer:${n.environment}:${n.display_width}x${n.display_height}`;
+    case "code_interpreter":
+      return `code_interpreter:${typeof n.container == "string" ? n.container : "auto"}`;
+    case "image_generation":
+      return `image_generation:${n.model || "gpt-image-1"}`;
+    case "local_shell":
+      return "local_shell";
+    default:
+      return `${n.type}:${JSON.stringify(n)}`;
+  }
+}
+function C(n) {
+  const t = /* @__PURE__ */ new Set(), o = [];
+  for (const e of n) {
+    const r = I(e);
+    t.has(r) || (t.add(r), o.push(e));
   }
+  return o;
+}
+class x {
+  description = "A plugin to aggregate and provide tools from base and context booths.";
+  id = "tool-provider";
+  name = "Tool Provider Plugin";
   /**
    * Before a message is sent, this hook gathers the tool keys from both the base and context booths,
    * retrieves the corresponding tool definitions from the `toolRegistry`, and adds them to the
@@ -806,16 +969,18 @@ class x {
    * @returns The updated response parameters with the aggregated list of tools.
    */
   async onBeforeMessageSend(t, o) {
-    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)
+    const e = t.boothRegistry.baseBoothConfig, r = t.boothRegistry.currentContextBoothConfig, i = [...e.tools || [], ...r?.tools || []].filter((a, d, g) => g.indexOf(a) === d).map(
+      (a) => t.toolRegistry.getTool(a)
     );
-    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);
+    if (e.mcp && i.push(...e.mcp), r?.mcp && i.push(...r.mcp), t.boothRegistry.isMultiBoothMode) {
+      const a = y(t.boothRegistry);
+      i.push(a);
     }
-    return l.push(...t.toolRegistry.getGlobalTools()), {
+    i.push(...t.toolRegistry.getGlobalTools());
+    const c = C(i);
+    return {
       ...o,
-      tools: l
+      tools: c
     };
   }
   /**
@@ -827,12 +992,10 @@ class x {
     return !1;
   }
 }
-class y {
-  constructor() {
-    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.");
-  }
+class m {
+  id = "tool-executor";
+  name = "Tool Executor";
+  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.
    * @param utilities - Repository utilities for accessing registries.
@@ -860,16 +1023,16 @@ class y {
           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(
+      const l = await s.execute(JSON.parse(r.arguments)), i = await t.pluginRegistry.runAfterToolCall(
         t,
         r,
-        a,
+        l,
         e
       );
       return {
         type: "function_call_output",
         call_id: r.call_id,
-        output: JSON.stringify(l)
+        output: JSON.stringify(i)
       };
     } catch (r) {
       console.error(`Error executing tool ${o.name}:`, r);
@@ -901,25 +1064,25 @@ class y {
    * @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) ?? [], s = y.extractFunctionCalls(r);
+    const r = e?.output ?? [], s = m.extractFunctionCalls(r);
     if (!s.length)
       return o;
-    const a = [];
-    for (let l = 0; l < s.length; l++) {
-      const u = s[l];
-      if (t.toolRegistry.isLocalTool(u.name))
+    const l = [];
+    for (let i = 0; i < s.length; i++) {
+      const c = s[i];
+      if (t.toolRegistry.isLocalTool(c.name))
         continue;
-      const g = {
+      const a = {
         responseParams: o,
         response: e,
-        toolCallIndex: l,
+        toolCallIndex: i,
         totalToolCalls: s.length
-      }, c = await this.executeToolCall(t, u, g);
-      a.push(c);
+      }, d = await this.executeToolCall(t, c, a);
+      l.push(d);
     }
     return {
       ...o,
-      input: [...o.input, ...a]
+      input: [...o.input, ...l]
     };
   }
   /**
@@ -931,12 +1094,10 @@ class y {
     return !1;
   }
 }
-class P {
-  constructor() {
-    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");
-  }
+class M {
+  description = "A plugin to ensure the interaction loop can be finished.";
+  id = "finish-turn-plugin";
+  name = "Finish Turn Plugin";
   /**
    * Before sending a message, this hook adds an instruction to the LLM to include a
    * specific marker (`__awaiting_user_response__`) when it expects a user response.
@@ -990,51 +1151,60 @@ class P {
     return o;
   }
 }
-const R = {
-  id: "orchestrator",
-  role: `
-    This booth serves as the orchestration layer that analyzes user intent and routes
-    conversations to the most appropriate specialized booth configuration.
-  `,
-  description: `
-    You are the orchestration layer responsible for determining which booth configuration
-    should be active based on user needs. Focus exclusively on routing - do not answer
-    questions or provide information directly to users.
-
-    [ROUTING STRATEGY]
-    - Analyze user request and route to the most appropriate specialized booth immediately
-    - This booth is only active for initial routing or when explicitly routed back to
-    - Once routed, the target booth handles the conversation until completion or re-routing
-
-    [ROUTING TARGETS]
-    - Ambiguous requests → Ask for clarification, then route appropriately
-
-    [CORE PRINCIPLES]
-    - Maintain illusion of single, continuous assistant
-    - Never reference booths, tools, or system mechanics to users
-    - Silent routing is preferred when intent is clear
-    - Only speak to users when clarification is absolutely necessary
-
-    [ROUTING BEHAVIOR]
-    - Clear intent: Route silently using route_to_booth() - do NOT respond to user
-    - Ambiguous intent: Ask user for clarification, then route once clarified
-    - Never respond to user AND route - it's either respond OR route, not both
-
-    [BEHAVIOR EXAMPLES]
-    - User: "How do I test my number?" → route_to_booth({ targetBooth: 'page-router-booth' })
-    - User: "I need help" → "What specifically would you like help with?" → then route based on response
-  `
-};
-function L(i, t) {
-  const o = new v(t), e = new _(), r = new d();
-  return new S({
-    llmAdapter: i,
+function P(n, t) {
+  const o = new R(t), e = new _(), r = new p();
+  return new A({
+    llmAdapter: n,
     booths: o,
     tools: e,
     boothPlugins: r
   });
 }
-class S {
+class A {
+  /**
+   * Represents a registry that maintains a collection of plugins for a booth system.
+   * The boothPluginRegistry is used to manage and access plugins that enhance
+   * or extend the booth's behavior or features.
+   *
+   * This variable is intended to provide a central location for plugin registration,
+   * retrieval, and management.
+   *
+   * @type {BoothPluginRegistry}
+   */
+  boothPluginRegistry;
+  /**
+   * Registry for managing booth configurations across the system.
+   * This registry maintains a collection of booth definitions that can be
+   * accessed by their unique identifiers.
+   *
+   * @type {BoothRegistry}
+   */
+  boothRegistry;
+  /**
+   * Primary processor for handling interactions between users and the booth system.
+   * Responsible for sending messages to the LLM, processing responses, and managing
+   * the interaction loop through plugins.
+   *
+   * @type {InteractionProcessor}
+   */
+  callProcessor;
+  /**
+   * Registry dedicated to system-level plugins that are always available.
+   * This includes core functionality plugins like conversation history and context providers,
+   * as well as any user-defined plugins from the boothPluginRegistry.
+   *
+   * @type {BoothPluginRegistry}
+   */
+  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
+   * for adding, removing, and retrieving tools.
+   *
+   * The `ToolRegistry` class typically serves as a centralized storage or management
+   * solution for tools that are used in a specific context or application.
+   */
+  toolRegistry;
   /**
    * Initializes a new instance of the CoreBooth class.
    * Sets up the plugin registries, system plugins, and interaction processor.
@@ -1045,62 +1215,24 @@ class S {
    * @param {ToolRegistry} options.tools - Registry containing tool configurations
    */
   constructor(t) {
-    /**
-     * Represents a registry that maintains a collection of plugins for a booth system.
-     * The boothPluginRegistry is used to manage and access plugins that enhance
-     * or extend the booth's behavior or features.
-     *
-     * This variable is intended to provide a central location for plugin registration,
-     * retrieval, and management.
-     *
-     * @type {BoothPluginRegistry}
-     */
-    n(this, "boothPluginRegistry");
-    /**
-     * Registry for managing booth configurations across the system.
-     * This registry maintains a collection of booth definitions that can be
-     * accessed by their unique identifiers.
-     *
-     * @type {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
-     * the interaction loop through plugins.
-     *
-     * @type {InteractionProcessor}
-     */
-    n(this, "callProcessor");
-    /**
-     * Registry dedicated to system-level plugins that are always available.
-     * This includes core functionality plugins like conversation history and context providers,
-     * as well as any user-defined plugins from the boothPluginRegistry.
-     *
-     * @type {BoothPluginRegistry}
-     */
-    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
-     * for adding, removing, and retrieving tools.
-     *
-     * The `ToolRegistry` class typically serves as a centralized storage or management
-     * solution for tools that are used in a specific context or application.
-     */
-    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);
+    if (this.boothPluginRegistry = t?.boothPlugins ?? new p(), this.boothRegistry = t.booths, this.toolRegistry = t?.tools ?? new _(), this.boothRegistry.setMultiBoothModeCallbacks(
+      () => {
+        const o = y(this.boothRegistry);
+        this.toolRegistry.registerTools([o]);
+      },
+      () => {
+      }
+    ), this.boothRegistry.isMultiBoothMode) {
+      const o = y(this.boothRegistry);
       this.toolRegistry.registerTools([o]);
     }
-    this.systemPluginsRegistry = new d(), this.systemPluginsRegistry.registerPlugins([
-      new I(t.sessionHistory),
-      new A(),
+    this.systemPluginsRegistry = new p(), this.systemPluginsRegistry.registerPlugins([
+      new v(t.sessionHistory),
+      new E(),
       new x(),
-      new y(),
-      new P()
-    ]), this.systemPluginsRegistry.registerPlugins(this.boothPluginRegistry.getPlugins()), this.callProcessor = new E(
+      new m(),
+      new M()
+    ]), this.systemPluginsRegistry.registerPlugins(this.boothPluginRegistry.getPlugins()), this.callProcessor = new B(
       this.boothRegistry,
       this.systemPluginsRegistry,
       this.toolRegistry,
@@ -1109,16 +1241,16 @@ class S {
   }
 }
 export {
-  d as BoothPluginRegistry,
-  v as BoothRegistry,
-  A as ContextProviderPlugin,
-  I as ConversationHistoryPlugin,
-  S as CoreBooth,
-  P as FinishTurnPlugin,
-  E as InteractionProcessor,
-  y as ToolExecutorPlugin,
+  p as BoothPluginRegistry,
+  R as BoothRegistry,
+  E as ContextProviderPlugin,
+  v as ConversationHistoryPlugin,
+  A as CoreBooth,
+  M as FinishTurnPlugin,
+  B as InteractionProcessor,
+  m as ToolExecutorPlugin,
   x as ToolProviderPlugin,
   _ as ToolRegistry,
-  L as createCoreBooth,
-  w as createRouteToBoothTool
+  P as createCoreBooth,
+  y as createRouteToBoothTool
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "booths",
   "private": false,
-  "version": "1.0.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -16,6 +16,7 @@
     }
   },
   "scripts": {
+    "build:pack": "npm install --package-lock-only && npm run build && npm pack",
     "build": "tsc && vite build",
     "format": "prettier --write \"src/**/*.{js,ts,json,css,scss,md}\"",
     "typecheck": "tsc --noEmit"