@storecraft/core/api/con.ai.logic.js

Core Package for storecraft

/**
 * @import {  } from './types.api.js'
 * @import { 
 *  AgentRunParameters, AgentRunResponse, AgentRunStreamResponse 
 * } from '../ai/agents/types.js'
 */
import { App } from "../index.js";
import { assert } from "./utils.func.js";

/**
 * @template {App} T
 * @param {T} app
 */
export const speakWithAgentSync = (app) => 
  /**
   * @description speak with agent synchronously.
   * @param {keyof T["__show_me_everything"]["agents"]} agent_handle agent identifier
   * @param {AgentRunParameters} params 
   * @returns {Promise<AgentRunResponse>}
   */
  async (agent_handle, params) => {
    const agent = app.__show_me_everything.agents?.[String(agent_handle)];
    assert(
      agent,
      `Agent ${String(agent_handle)} not found !`
    );

    return agent.run(
      params
    );
  }

/**
 * @template {App} T
 * @param {T} app
 */
export const speakWithAgentStream = (app) => 
  /**
   * @description speak with agent with streaming.
   * @param {keyof T["__show_me_everything"]["agents"]} agent_handle agent identifier
   * @param {AgentRunParameters} params 
   * @returns {Promise<AgentRunStreamResponse>}
   */
  async (agent_handle, params) => {
    
    const agent = app.__show_me_everything.agents?.[String(agent_handle)];

    assert(
      agent,
      `Agent ${String(agent_handle)} not found !`
    );

    return agent.runStream(
      params
    );
  }


/**
 * @template {App} T
 * @param {T} app
 */  
export const inter = app => {
  return {
    speakWithAgentSync: speakWithAgentSync(app),
    speakWithAgentStream: speakWithAgentStream(app),
  }
}