@sjts/ai-shared 30.2.2

package/LICENCE

@@ -0,0 +1,5 @@
+
+Copyright (C) Mr Stephen James - All Rights Reserved
+Unauthorized copying of any files within this source code repository, via any medium is strictly prohibited
+Proprietary and confidential
+Written by Steve James <steve@stevejames.dev>, March 2019

package/dist/enums/AIModelName.d.ts

@@ -0,0 +1,36 @@
+export declare enum AIModelName {
+    TEXT_EMBED = "Text Embed",
+    GPT4_1 = "GPT 4.1",
+    O3 = "o3",
+    O4Mini = "o4 Mini",
+    O3Mini = "o3 Mini",
+    NOVA_PRO = "Nova Pro",
+    NOVA_MICRO = "Nova Micro",
+    NOVA_LITE = "Nova Lite",
+    CLAUDE4_OPUS = "Claude 4.0 Opus",
+    CLAUDE4_SONNET = "Claude 4.0 Sonnet",
+    CLAUDE3_7_SONNET = "Claude 3.7 Sonnet",
+    CLAUDE3_5_SONNET = "Claude 3.5 Sonnet",
+    CLAUDE3_5_HAIKU = "Claude 3.5 Haiku",
+    GEMINI_2_5_FLASH = "Gemini 2.5 Flash",
+    GEMINI_2_5_PRO = "Gemini 2.5 Pro",
+    GEMINI_2_0_PRO = "Gemini 2.0 Pro",
+    GEMINI_2_0_FLASH = "Gemini 2.0 Flash",
+    GROK_3 = "Grok 3",
+    GROK_2 = "Grok 2",
+    GROK_3_FAST = "Grok 3 Fast",
+    GROK_3_MINI = "Grok 3 Mini",
+    GROK_3_MINI_FAST = "Grok 3 Mini Fast",
+    MISTRAL_LARGE = "Mistral Large",
+    MISTRAL_MEDIUM = "Mistral Medium",
+    MISTRAL_SMALL = "Mistral Small",
+    QWEN_3 = "Qwen 3",
+    QWEN_QWQ = "Qwen QwQ",
+    LLAMA4_MAVERICK = "Llama 4 Maverick",
+    LLAMA4_SCOUT = "Llama 4 Scout",
+    LLAMA3_3 = "Llama 3.3",
+    DEEPSEEK_V3 = "DeepSeek V3",
+    DEEPSEEK_R1 = "DeepSeek R1",
+    MERCURY = "Mercury",
+    MERCURY_CODER = "Mercury Coder"
+}

package/dist/enums/AIModelName.js

@@ -0,0 +1,48 @@
+export var AIModelName;
+(function (AIModelName) {
+    // GENERIC
+    AIModelName["TEXT_EMBED"] = "Text Embed";
+    // OPEN AI
+    AIModelName["GPT4_1"] = "GPT 4.1";
+    AIModelName["O3"] = "o3";
+    AIModelName["O4Mini"] = "o4 Mini";
+    AIModelName["O3Mini"] = "o3 Mini";
+    // NOVA
+    AIModelName["NOVA_PRO"] = "Nova Pro";
+    AIModelName["NOVA_MICRO"] = "Nova Micro";
+    AIModelName["NOVA_LITE"] = "Nova Lite";
+    // CLAUDE
+    AIModelName["CLAUDE4_OPUS"] = "Claude 4.0 Opus";
+    AIModelName["CLAUDE4_SONNET"] = "Claude 4.0 Sonnet";
+    AIModelName["CLAUDE3_7_SONNET"] = "Claude 3.7 Sonnet";
+    AIModelName["CLAUDE3_5_SONNET"] = "Claude 3.5 Sonnet";
+    AIModelName["CLAUDE3_5_HAIKU"] = "Claude 3.5 Haiku";
+    // GEMINI
+    AIModelName["GEMINI_2_5_FLASH"] = "Gemini 2.5 Flash";
+    AIModelName["GEMINI_2_5_PRO"] = "Gemini 2.5 Pro";
+    AIModelName["GEMINI_2_0_PRO"] = "Gemini 2.0 Pro";
+    AIModelName["GEMINI_2_0_FLASH"] = "Gemini 2.0 Flash";
+    // GROK
+    AIModelName["GROK_3"] = "Grok 3";
+    AIModelName["GROK_2"] = "Grok 2";
+    AIModelName["GROK_3_FAST"] = "Grok 3 Fast";
+    AIModelName["GROK_3_MINI"] = "Grok 3 Mini";
+    AIModelName["GROK_3_MINI_FAST"] = "Grok 3 Mini Fast";
+    // MIXSTRAL
+    AIModelName["MISTRAL_LARGE"] = "Mistral Large";
+    AIModelName["MISTRAL_MEDIUM"] = "Mistral Medium";
+    AIModelName["MISTRAL_SMALL"] = "Mistral Small";
+    // QWEN
+    AIModelName["QWEN_3"] = "Qwen 3";
+    AIModelName["QWEN_QWQ"] = "Qwen QwQ";
+    // LLAMA
+    AIModelName["LLAMA4_MAVERICK"] = "Llama 4 Maverick";
+    AIModelName["LLAMA4_SCOUT"] = "Llama 4 Scout";
+    AIModelName["LLAMA3_3"] = "Llama 3.3";
+    // DEEPSEEK
+    AIModelName["DEEPSEEK_V3"] = "DeepSeek V3";
+    AIModelName["DEEPSEEK_R1"] = "DeepSeek R1";
+    // MERCURY
+    AIModelName["MERCURY"] = "Mercury";
+    AIModelName["MERCURY_CODER"] = "Mercury Coder";
+})(AIModelName || (AIModelName = {}));

package/dist/enums/AIProvider.d.ts

@@ -0,0 +1,14 @@
+export declare enum AIProvider {
+    OPENAI = "Open AI",
+    ANTHROPIC = "Anthropic",
+    GOOGLE = "Google",
+    AMAZON = "Amazon",
+    XAI = "xAI",
+    MISTRAL = "Mistral",
+    TOGETHERAI = "Together AI",
+    GROQ = "Groq",
+    SAMBANOVA = "Samba Nova",
+    CEREBRAS = "Cerebras",
+    VOYAGEAI = "Voyage AI",
+    INCEPTION_LABS = "Inception Labs"
+}

package/dist/enums/AIProvider.js

@@ -0,0 +1,15 @@
+export var AIProvider;
+(function (AIProvider) {
+    AIProvider["OPENAI"] = "Open AI";
+    AIProvider["ANTHROPIC"] = "Anthropic";
+    AIProvider["GOOGLE"] = "Google";
+    AIProvider["AMAZON"] = "Amazon";
+    AIProvider["XAI"] = "xAI";
+    AIProvider["MISTRAL"] = "Mistral";
+    AIProvider["TOGETHERAI"] = "Together AI";
+    AIProvider["GROQ"] = "Groq";
+    AIProvider["SAMBANOVA"] = "Samba Nova";
+    AIProvider["CEREBRAS"] = "Cerebras";
+    AIProvider["VOYAGEAI"] = "Voyage AI";
+    AIProvider["INCEPTION_LABS"] = "Inception Labs";
+})(AIProvider || (AIProvider = {}));

package/dist/enums/AIToolChoice.d.ts

@@ -0,0 +1,5 @@
+export declare enum AIToolChoice {
+    REQUIRED = "required",
+    AUTO = "auto",
+    NONE = "none"
+}

package/dist/enums/AIToolChoice.js

@@ -0,0 +1,6 @@
+export var AIToolChoice;
+(function (AIToolChoice) {
+    AIToolChoice["REQUIRED"] = "required";
+    AIToolChoice["AUTO"] = "auto";
+    AIToolChoice["NONE"] = "none";
+})(AIToolChoice || (AIToolChoice = {}));

package/dist/enums/BeatStage.d.ts

@@ -0,0 +1,10 @@
+export declare enum BeatStage {
+    START = "start",
+    RECOLLECTION = "recollection",
+    PERCEPTION = "perception",
+    TASK_EXECUTION = "task_execution",
+    EXECUTIVE_CONTROL = "executive_control",
+    ACTUATION = "actuation",
+    STOP = "stop"
+}
+export declare const BeatStages: BeatStage[];

package/dist/enums/BeatStage.js

@@ -0,0 +1,18 @@
+export var BeatStage;
+(function (BeatStage) {
+    BeatStage["START"] = "start";
+    BeatStage["RECOLLECTION"] = "recollection";
+    BeatStage["PERCEPTION"] = "perception";
+    BeatStage["TASK_EXECUTION"] = "task_execution";
+    BeatStage["EXECUTIVE_CONTROL"] = "executive_control";
+    BeatStage["ACTUATION"] = "actuation";
+    BeatStage["STOP"] = "stop";
+})(BeatStage || (BeatStage = {}));
+export const BeatStages = [
+    BeatStage.START,
+    BeatStage.RECOLLECTION,
+    BeatStage.PERCEPTION,
+    BeatStage.EXECUTIVE_CONTROL,
+    BeatStage.ACTUATION,
+    BeatStage.STOP,
+];

package/dist/enums/BeatStatus.d.ts

@@ -0,0 +1,6 @@
+export declare enum AgiBeatStatus {
+    RUNNING = "RUNNING",
+    CANCELLED = "CANCELLED",
+    COMPLETE = "COMPLETE",
+    FAILED = "FAILED"
+}

package/dist/enums/BeatStatus.js

@@ -0,0 +1,7 @@
+export var AgiBeatStatus;
+(function (AgiBeatStatus) {
+    AgiBeatStatus["RUNNING"] = "RUNNING";
+    AgiBeatStatus["CANCELLED"] = "CANCELLED";
+    AgiBeatStatus["COMPLETE"] = "COMPLETE";
+    AgiBeatStatus["FAILED"] = "FAILED";
+})(AgiBeatStatus || (AgiBeatStatus = {}));

package/dist/enums/index.d.ts

@@ -0,0 +1,5 @@
+export * from './AIModelName.js';
+export * from './AIProvider.js';
+export * from './AIToolChoice.js';
+export * from './BeatStage.js';
+export * from './BeatStatus.js';

package/dist/enums/index.js

@@ -0,0 +1,5 @@
+export * from './AIModelName.js';
+export * from './AIProvider.js';
+export * from './AIToolChoice.js';
+export * from './BeatStage.js';
+export * from './BeatStatus.js';

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './enums/index.js';
+export * from './llms.js';
+export * from './llmsets.js';
+export * from './types/index.js';
+export * from './utils/index.js';

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './enums/index.js';
+export * from './llms.js';
+export * from './llmsets.js';
+export * from './types/index.js';
+export * from './utils/index.js';

package/dist/llms.d.ts

@@ -0,0 +1,4 @@
+import { AIProvider, AIModelName as M } from './enums/index.js';
+import { LLM } from './types/LLM.js';
+export declare const llms: Record<AIProvider, LLM[]>;
+export declare const findLLM: (provider: AIProvider, model: M) => LLM;

package/dist/llms.js

@@ -0,0 +1,96 @@
+import { AIModelName as M, AIProvider as P } from './enums/index.js';
+import { makeLLM as make } from './types/LLM.js';
+const T = true;
+const F = false;
+// prettier-ignore
+export const llms = {
+    // Open AI
+    [P.OPENAI]: [
+        make(P.OPENAI, M.GPT4_1, 'gpt-4.1-2025-04-14', T, T, 2, 8, 88.83),
+        make(P.OPENAI, M.O3, 'o3', T, T, 10, 40, 17.9),
+        make(P.OPENAI, M.O4Mini, 'o4-mini-2025-04-16', T, T, 1.1, 4.4, 25.13),
+        make(P.OPENAI, M.O3Mini, 'o3-mini', T, T, 1.1, 4.4, 30.62),
+        make(P.OPENAI, M.TEXT_EMBED, 'text-embedding-3-small')
+    ],
+    // Anthropic
+    [P.ANTHROPIC]: [
+        make(P.ANTHROPIC, M.CLAUDE4_OPUS, 'claude-opus-4-20250514', T, T, 15, 75, 64.11),
+        make(P.ANTHROPIC, M.CLAUDE4_SONNET, 'claude-sonnet-4-20250514', T, T, 3, 15, 64.11),
+        make(P.ANTHROPIC, M.CLAUDE3_7_SONNET, 'claude-3-7-sonnet-latest', T, T, 3, 15, 64.11),
+        make(P.ANTHROPIC, M.CLAUDE3_5_SONNET, 'claude-3-5-sonnet-latest', T, T, 3, 15, 64.55),
+        make(P.ANTHROPIC, M.CLAUDE3_5_HAIKU, 'claude-3-5-haiku-latest', T, T, 0.8, 4, 61.3),
+    ],
+    // Amazon
+    [P.AMAZON]: [
+        make(P.AMAZON, M.NOVA_PRO, 'arn:aws:bedrock:ap-southeast-2:396657583517:inference-profile/apac.amazon.nova-pro-v1:0', T, T),
+        make(P.AMAZON, M.NOVA_MICRO, 'amazon.nova-micro-v1:0', T, T),
+        make(P.AMAZON, M.NOVA_LITE, 'amazon.nova-lite-v1:0', T, T),
+        make(P.AMAZON, M.CLAUDE3_5_SONNET, 'arn:aws:bedrock:ap-southeast-2:396657583517:inference-profile/apac.anthropic.claude-3-5-sonnet-20241022-v2:0', T, T),
+        make(P.AMAZON, M.CLAUDE3_7_SONNET, 'arn:aws:bedrock:ap-southeast-2:396657583517:inference-profile/apac.anthropic.claude-3-7-sonnet-20250219-v1:0', T, T)
+    ],
+    // Google
+    [P.GOOGLE]: [
+        make(P.GOOGLE, M.GEMINI_2_5_PRO, 'gemini-2.5-pro-exp-03-25', T, T, 1.25, 15, 74.31),
+        make(P.GOOGLE, M.GEMINI_2_5_FLASH, 'models/gemini-2.5-flash-preview-04-17', T, T, 0.15, 0.6, 133.58),
+        make(P.GOOGLE, M.GEMINI_2_0_FLASH, 'gemini-2.0-flash', T, T, 0.1, 0.4, 144.4),
+    ],
+    // Grok
+    [P.XAI]: [
+        make(P.XAI, M.GROK_3, 'grok-3-beta', T, T, 3, 15, 34.63),
+        make(P.XAI, M.GROK_3_FAST, 'grok-3-fast-beta', T, T, 5, 25, 80.43),
+        make(P.XAI, M.GROK_3_MINI, 'grok-3-mini-beta', T, T, 0.3, 0.5, 32.03),
+        make(P.XAI, M.GROK_3_MINI_FAST, 'grok-3-mini-fast-beta', T, T, 0.6, 4, 59.84),
+    ],
+    // Mistral
+    [P.MISTRAL]: [
+        make(P.MISTRAL, M.MISTRAL_LARGE, 'mistral-large-latest', T, T, 2, 6, 20.15),
+        make(P.MISTRAL, M.MISTRAL_MEDIUM, 'mistral-medium-2505', T, T, 0.4, 2),
+        make(P.MISTRAL, M.MISTRAL_SMALL, 'mistral-small-latest', T, T, 0.1, 0.3, 56.65),
+    ],
+    // Together AI
+    [P.TOGETHERAI]: [
+        make(P.TOGETHERAI, M.LLAMA4_MAVERICK, 'meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8', T, T, 0.27, 0.85, 78.49),
+        make(P.TOGETHERAI, M.LLAMA4_SCOUT, 'meta-llama/Llama-4-Scout-17B-16E-Instruct', T, T, 0.18, 0.59, 71.58),
+        make(P.TOGETHERAI, M.LLAMA3_3, 'meta-llama/Llama-3.3-70B-Instruct-Turbo', T, T, 0, .88, 153.97),
+        make(P.TOGETHERAI, M.DEEPSEEK_V3, 'deepseek-ai/DeepSeek-V3', T, T, 0, 1.25, 48.43),
+        make(P.TOGETHERAI, M.QWEN_3, 'Qwen/Qwen3-235B-A22B-fp8-tput', T, T, 0.2, 0.6, 11.87),
+    ],
+    // Groq
+    [P.GROQ]: [
+        make(P.GROQ, M.LLAMA4_MAVERICK, 'meta-llama/llama-4-maverick-17b-128e-instruct', T, T, 0.2, 0.6, 174.28),
+        make(P.GROQ, M.LLAMA4_SCOUT, 'meta-llama/llama-4-scout-17b-16e-instruct', T, T, 0.11, 0.34, 321.89),
+        make(P.GROQ, M.LLAMA3_3, 'llama-3.3-70b-versatile', T, T, 0.59, 0.79, 183.27),
+        make(P.GROQ, M.DEEPSEEK_R1, 'deepseek-r1-distill-llama-70b', T, T, 0.29, 0.39, 149.36),
+        make(P.GROQ, M.QWEN_QWQ, 'qwen-qwq-32b', T, T, 0.29, 0.39, 149.36),
+    ],
+    // Inception Labs
+    [P.INCEPTION_LABS]: [
+        make(P.INCEPTION_LABS, M.MERCURY, 'mercury'),
+        make(P.INCEPTION_LABS, M.MERCURY_CODER, 'mercury-coder'),
+    ],
+    // SambaNova
+    [P.SAMBANOVA]: [
+        make(P.SAMBANOVA, M.DEEPSEEK_V3, 'DeepSeek-V3-0324', T, T, 3, 4.5, 140),
+        make(P.SAMBANOVA, M.LLAMA4_MAVERICK, 'Llama-4-Maverick-17B-128E-Instruct', T, T, 0.63, 1.8, 272.04),
+        make(P.SAMBANOVA, M.LLAMA4_SCOUT, 'Llama-4-Scout-17B-16E-Instruct', T, T, 0.4, 0.7, 211.93),
+        make(P.SAMBANOVA, M.QWEN_3, 'Qwen3-32B', T, T, 0.29, 0.39, 130.71),
+    ],
+    // Cerebras
+    [P.CEREBRAS]: [
+        make(P.CEREBRAS, M.LLAMA4_SCOUT, 'llama-4-scout-17b-16e-instruct', T, T),
+        make(P.CEREBRAS, M.LLAMA3_3, 'llama-3.3-70b', T, T),
+    ],
+    // Voyage AI
+    [P.VOYAGEAI]: [
+        make(P.VOYAGEAI, M.TEXT_EMBED, 'voyage-3-large')
+    ],
+};
+export const findLLM = (provider, model) => {
+    const models = llms[provider];
+    if (!models)
+        throw new Error(`Provider ${provider} not found`);
+    const retVal = models.find(m => m.modelName === model);
+    if (!retVal)
+        throw new Error(`Model ${model} not found for provider ${provider}`);
+    return retVal;
+};

package/dist/llmsets.d.ts

@@ -0,0 +1,7 @@
+import { LLMSet } from './types';
+export declare const llmsets: {
+    level4: LLMSet;
+    level3: LLMSet;
+    level2: LLMSet;
+    level1: LLMSet;
+};

package/dist/llmsets.js

@@ -0,0 +1,27 @@
+import { AIModelName, AIProvider } from './enums';
+import { LLMIntelligenceLevel, makeLLMKey } from './types';
+const CLAUDE4 = makeLLMKey(AIProvider.ANTHROPIC, AIModelName.CLAUDE4_SONNET);
+const CLAUDE3_5 = makeLLMKey(AIProvider.ANTHROPIC, AIModelName.CLAUDE3_5_SONNET);
+const LLAMA4 = makeLLMKey(AIProvider.GROQ, AIModelName.LLAMA4_MAVERICK);
+export const llmsets = {
+    level4: {
+        [LLMIntelligenceLevel.SUPERSMART]: CLAUDE4,
+        [LLMIntelligenceLevel.SMART]: CLAUDE4,
+        [LLMIntelligenceLevel.QUICK]: LLAMA4,
+    },
+    level3: {
+        [LLMIntelligenceLevel.SUPERSMART]: CLAUDE4,
+        [LLMIntelligenceLevel.SMART]: CLAUDE3_5,
+        [LLMIntelligenceLevel.QUICK]: LLAMA4,
+    },
+    level2: {
+        [LLMIntelligenceLevel.SUPERSMART]: CLAUDE4,
+        [LLMIntelligenceLevel.SMART]: LLAMA4,
+        [LLMIntelligenceLevel.QUICK]: LLAMA4,
+    },
+    level1: {
+        [LLMIntelligenceLevel.SUPERSMART]: LLAMA4,
+        [LLMIntelligenceLevel.SMART]: LLAMA4,
+        [LLMIntelligenceLevel.QUICK]: LLAMA4,
+    },
+};

package/dist/types/AIConfig.d.ts

@@ -0,0 +1,27 @@
+import { APIConfig } from '@sjts/lib-utils';
+import { AIToolChoice } from '../enums/AIToolChoice.js';
+import { LLM } from './LLM.js';
+export type AIModelConfig = {
+    llm: LLM;
+    api: APIConfig;
+};
+export type AIConfig = AIModelConfig & {
+    timeout?: number;
+    max_tokens?: number;
+    temperature?: number;
+    top_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    dimensions?: number;
+    tool_choice?: AIToolChoice;
+    jsonMode?: boolean;
+};
+export declare const defaultAIConfig: {
+    timeout: number;
+    max_tokens: number;
+    temperature: number;
+    top_p: number;
+    frequency_penalty: number;
+    presence_penalty: number;
+    tool_choice: AIToolChoice;
+};

package/dist/types/AIConfig.js

@@ -0,0 +1,10 @@
+import { AIToolChoice } from '../enums/AIToolChoice.js';
+export const defaultAIConfig = {
+    timeout: 1000 * 60,
+    max_tokens: 2048 * 2,
+    temperature: 0.5,
+    top_p: 1,
+    frequency_penalty: 0,
+    presence_penalty: 0,
+    tool_choice: AIToolChoice.AUTO,
+};

package/dist/types/AIEmbedding.d.ts

@@ -0,0 +1 @@
+export type AIEmbedding = number[];

package/dist/types/AIEmbedding.js

@@ -0,0 +1 @@
+export {};

package/dist/types/AIEvent.d.ts

@@ -0,0 +1,30 @@
+import { AIEventType } from './AIEventType.js';
+import { AIImage } from './AIImage.js';
+import { AIToolCall } from './AIToolCall.js';
+import { AIToolResponse } from './AIToolResponse.js';
+export type AIEventBase = {
+    id?: string;
+    type: AIEventType;
+    createdAt?: string;
+    updatedAt?: string;
+};
+export type AIEventUserChat = AIEventBase & {
+    type: AIEventType.USER_CHAT;
+    content: string;
+    images?: AIImage[];
+};
+export type AIEventAIChat = AIEventBase & {
+    type: AIEventType.AI_CHAT;
+    content: string;
+};
+export type AIEventToolRequest = AIEventBase & {
+    type: AIEventType.TOOL_REQUEST;
+    content?: string;
+    toolCalls: AIToolCall[];
+};
+export type AIEventToolResponse = AIEventBase & AIToolResponse & {
+    type: AIEventType.TOOL_RESPONSE;
+};
+export type AIEvent = AIEventAIChat | AIEventUserChat | AIEventToolRequest | AIEventToolResponse;
+export type AIEventChat = AIEventAIChat | AIEventUserChat;
+export type AIEventTool = AIEventToolRequest | AIEventToolResponse;

package/dist/types/AIEvent.js

@@ -0,0 +1 @@
+export {};

package/dist/types/AIEventType.d.ts

@@ -0,0 +1,6 @@
+export declare enum AIEventType {
+    USER_CHAT = "USER_CHAT",
+    AI_CHAT = "AI_CHAT",
+    TOOL_REQUEST = "TOOL_REQUEST",
+    TOOL_RESPONSE = "TOOL_RESPONSE"
+}

package/dist/types/AIEventType.js

@@ -0,0 +1,7 @@
+export var AIEventType;
+(function (AIEventType) {
+    AIEventType["USER_CHAT"] = "USER_CHAT";
+    AIEventType["AI_CHAT"] = "AI_CHAT";
+    AIEventType["TOOL_REQUEST"] = "TOOL_REQUEST";
+    AIEventType["TOOL_RESPONSE"] = "TOOL_RESPONSE";
+})(AIEventType || (AIEventType = {}));

package/dist/types/AIImage.d.ts

@@ -0,0 +1,4 @@
+export type AIImage = {
+    mime: string;
+    data: string;
+};

package/dist/types/AIImage.js

@@ -0,0 +1 @@
+export {};

package/dist/types/AIThoughtInput.d.ts

@@ -0,0 +1,7 @@
+import { AIEvent } from './AIEvent.js';
+import { AITool } from './AITool.js';
+export type AIThoughtInput = {
+    context?: string;
+    history: AIEvent[];
+    tools?: AITool[];
+};

package/dist/types/AIThoughtInput.js

@@ -0,0 +1 @@
+export {};

package/dist/types/AIThoughtOutput.d.ts

@@ -0,0 +1,2 @@
+import { AIEventAIChat, AIEventToolRequest } from './AIEvent.js';
+export type AIThoughtOutput = AIEventAIChat | AIEventToolRequest;

package/dist/types/AIThoughtOutput.js

@@ -0,0 +1 @@
+export {};

package/dist/types/AITool.d.ts

@@ -0,0 +1,6 @@
+import { Params } from './Param.js';
+export type AITool = {
+    key: string;
+    description?: string;
+    params: Params;
+};

package/dist/types/AITool.js

@@ -0,0 +1 @@
+export {};

package/dist/types/AIToolCall.d.ts

@@ -0,0 +1,5 @@
+export type AIToolCall = {
+    callId: string;
+    tool: string;
+    params: any;
+};

package/dist/types/AIToolCall.js

@@ -0,0 +1 @@
+export {};

package/dist/types/AIToolResponse.d.ts

@@ -0,0 +1,5 @@
+export type AIToolResponse = {
+    callId: string;
+    tool: string;
+    content: string;
+};

package/dist/types/AIToolResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/types/LLM.d.ts

@@ -0,0 +1,13 @@
+export type LLM = {
+    key: string;
+    provider: string;
+    modelName: string;
+    model: string;
+    tooluse?: boolean;
+    vision?: boolean;
+    speed: number;
+    costIn: number;
+    costOut: number;
+};
+export declare const makeLLMKey: (provider: string, modelName: string) => string;
+export declare function makeLLM(provider: string, modelName: string, model: string, tooluse?: boolean, vision?: boolean, costIn?: number, costOut?: number, speed?: number): LLM;

package/dist/types/LLM.js

@@ -0,0 +1,14 @@
+export const makeLLMKey = (provider, modelName) => `${provider}###${modelName}`;
+export function makeLLM(provider, modelName, model, tooluse = false, vision = false, costIn = 99999, costOut = 99999, speed = 99999) {
+    return {
+        key: makeLLMKey(provider, modelName),
+        provider,
+        modelName,
+        model,
+        tooluse,
+        vision,
+        speed,
+        costIn,
+        costOut,
+    };
+}

package/dist/types/LLMIntelligenceLevel.d.ts

@@ -0,0 +1,5 @@
+export declare enum LLMIntelligenceLevel {
+    SUPERSMART = "supersmart",
+    SMART = "smart",
+    QUICK = "quick"
+}

package/dist/types/LLMIntelligenceLevel.js

@@ -0,0 +1,6 @@
+export var LLMIntelligenceLevel;
+(function (LLMIntelligenceLevel) {
+    LLMIntelligenceLevel["SUPERSMART"] = "supersmart";
+    LLMIntelligenceLevel["SMART"] = "smart";
+    LLMIntelligenceLevel["QUICK"] = "quick";
+})(LLMIntelligenceLevel || (LLMIntelligenceLevel = {}));

package/dist/types/LLMSet.d.ts

@@ -0,0 +1,6 @@
+import { LLMIntelligenceLevel } from './LLMIntelligenceLevel.js';
+export type LLMSet = {
+    [LLMIntelligenceLevel.SUPERSMART]: string;
+    [LLMIntelligenceLevel.SMART]: string;
+    [LLMIntelligenceLevel.QUICK]: string;
+};

package/dist/types/LLMSet.js

@@ -0,0 +1 @@
+import { LLMIntelligenceLevel } from './LLMIntelligenceLevel.js';

package/dist/types/Param.d.ts

@@ -0,0 +1,14 @@
+import { ParamType } from './ParamType.js';
+export type Params = {
+    [key: string]: Param;
+};
+export type Param = {
+    type: ParamType;
+    min?: number;
+    max?: number;
+    description?: string;
+    enum?: string[];
+    example?: any;
+    required?: boolean;
+    properties?: Params;
+};

package/dist/types/Param.js

@@ -0,0 +1 @@
+export {};

package/dist/types/ParamType.d.ts

@@ -0,0 +1,14 @@
+export declare enum ParamType {
+    BOOLEAN = "BOOLEAN",
+    BOOLEAN_ARRAY = "BOOLEAN_ARRAY",
+    NUMBER = "NUMBER",
+    NUMBER_ARRAY = "NUMBER_ARRAY",
+    STRING = "STRING",
+    STRING_ARRAY = "STRING_ARRAY",
+    DATE = "DATE",
+    DATE_ARRAY = "DATE_ARRAY",
+    DATE_TIME = "DATE_TIME",
+    DATE_TIME_ARRAY = "DATE_TIME_ARRAY",
+    OBJECT = "OBJECT",
+    OBJECT_ARRAY = "OBJECT_ARRAY"
+}

package/dist/types/ParamType.js

@@ -0,0 +1,15 @@
+export var ParamType;
+(function (ParamType) {
+    ParamType["BOOLEAN"] = "BOOLEAN";
+    ParamType["BOOLEAN_ARRAY"] = "BOOLEAN_ARRAY";
+    ParamType["NUMBER"] = "NUMBER";
+    ParamType["NUMBER_ARRAY"] = "NUMBER_ARRAY";
+    ParamType["STRING"] = "STRING";
+    ParamType["STRING_ARRAY"] = "STRING_ARRAY";
+    ParamType["DATE"] = "DATE";
+    ParamType["DATE_ARRAY"] = "DATE_ARRAY";
+    ParamType["DATE_TIME"] = "DATE_TIME";
+    ParamType["DATE_TIME_ARRAY"] = "DATE_TIME_ARRAY";
+    ParamType["OBJECT"] = "OBJECT";
+    ParamType["OBJECT_ARRAY"] = "OBJECT_ARRAY";
+})(ParamType || (ParamType = {}));

package/dist/types/Prompt.d.ts

@@ -0,0 +1,5 @@
+import { AIImage } from './AIImage.js';
+export type Prompt = {
+    text: string;
+    images?: AIImage[];
+};

package/dist/types/Prompt.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+export * from './AIConfig.js';
+export * from './AIEmbedding.js';
+export * from './AIEvent.js';
+export * from './AIEventType.js';
+export * from './AIImage.js';
+export * from './AIThoughtInput.js';
+export * from './AIThoughtOutput.js';
+export * from './AITool.js';
+export * from './AIToolCall.js';
+export * from './AIToolResponse.js';
+export * from './LLM.js';
+export * from './LLMIntelligenceLevel.js';
+export * from './LLMSet.js';
+export * from './Param.js';
+export * from './ParamType.js';
+export * from './Prompt.js';

package/dist/types/index.js

@@ -0,0 +1,16 @@
+export * from './AIConfig.js';
+export * from './AIEmbedding.js';
+export * from './AIEvent.js';
+export * from './AIEventType.js';
+export * from './AIImage.js';
+export * from './AIThoughtInput.js';
+export * from './AIThoughtOutput.js';
+export * from './AITool.js';
+export * from './AIToolCall.js';
+export * from './AIToolResponse.js';
+export * from './LLM.js';
+export * from './LLMIntelligenceLevel.js';
+export * from './LLMSet.js';
+export * from './Param.js';
+export * from './ParamType.js';
+export * from './Prompt.js';

package/dist/utils/index.d.ts

@@ -0,0 +1,15 @@
+export * from './makeBulletList.js';
+export * from './makeCodeBlock.js';
+export * from './makeH1.js';
+export * from './makeH2.js';
+export * from './makeH3.js';
+export * from './makeH4.js';
+export * from './makeJSONBlock.js';
+export * from './makeTextBlock.js';
+export * from './makeTypescriptBlock.js';
+export * from './mdAdjustHeadings.js';
+export * from './mergePrompts.js';
+export * from './parseJson.js';
+export * from './promptAdjustHeadings.js';
+export * from './textJoin.js';
+export * from './trim.js';

package/dist/utils/index.js

@@ -0,0 +1,15 @@
+export * from './makeBulletList.js';
+export * from './makeCodeBlock.js';
+export * from './makeH1.js';
+export * from './makeH2.js';
+export * from './makeH3.js';
+export * from './makeH4.js';
+export * from './makeJSONBlock.js';
+export * from './makeTextBlock.js';
+export * from './makeTypescriptBlock.js';
+export * from './mdAdjustHeadings.js';
+export * from './mergePrompts.js';
+export * from './parseJson.js';
+export * from './promptAdjustHeadings.js';
+export * from './textJoin.js';
+export * from './trim.js';

package/dist/utils/makeBulletList.d.ts

@@ -0,0 +1 @@
+export declare function makeBulletList(content: string | string[], emtpyText?: string): string;

package/dist/utils/makeBulletList.js

@@ -0,0 +1,24 @@
+export function makeBulletList(content, emtpyText = '') {
+    return Array.isArray(content)
+        ? !content?.length
+            ? emtpyText
+            : content.map(c => indentAndBullet(c)).join('\n')
+        : !content
+            ? emtpyText
+            : content;
+}
+function indentAndBullet(c) {
+    const tabSplit = c.split('\t');
+    let blah = true;
+    let output = '- ';
+    for (let bit of tabSplit) {
+        if (!bit && blah) {
+            output = `\t${output}`;
+        }
+        else {
+            blah = false;
+            output += bit;
+        }
+    }
+    return output.endsWith('.') ? output : output + '.';
+}

package/dist/utils/makeCodeBlock.d.ts

@@ -0,0 +1 @@
+export declare function makeCodeBlock(content: string, emptyText?: string): string;

package/dist/utils/makeCodeBlock.js

@@ -0,0 +1,3 @@
+export function makeCodeBlock(content, emptyText = 'No data') {
+    return !content?.length ? emptyText : '```\n' + content + '\n```';
+}

package/dist/utils/makeH1.d.ts

@@ -0,0 +1 @@
+export declare function makeH1(title: string): string;

package/dist/utils/makeH1.js

@@ -0,0 +1,5 @@
+export function makeH1(title) {
+    if (!title)
+        return '';
+    return `# ${title}`;
+}

package/dist/utils/makeH2.d.ts

@@ -0,0 +1 @@
+export declare function makeH2(title: string): string;

package/dist/utils/makeH2.js

@@ -0,0 +1,5 @@
+export function makeH2(title) {
+    if (!title)
+        return '';
+    return `## ${title}`;
+}

package/dist/utils/makeH3.d.ts

@@ -0,0 +1 @@
+export declare function makeH3(title: string): string;

package/dist/utils/makeH3.js

@@ -0,0 +1,5 @@
+export function makeH3(title) {
+    if (!title)
+        return '';
+    return `### ${title}`;
+}

package/dist/utils/makeH4.d.ts

@@ -0,0 +1 @@
+export declare function makeH4(title: string): string;

package/dist/utils/makeH4.js

@@ -0,0 +1,5 @@
+export function makeH4(title) {
+    if (!title)
+        return '';
+    return `#### ${title}`;
+}

package/dist/utils/makeJSONBlock.d.ts

@@ -0,0 +1 @@
+export declare function makeJSONBlock(content: any | any[], emptyText?: string): string;

package/dist/utils/makeJSONBlock.js

@@ -0,0 +1,95 @@
+export function makeJSONBlock(content, emptyText = 'No data') {
+    return Array.isArray(content)
+        ? !content?.length
+            ? emptyText
+            : '```json\n' + parseJsonWithComments(content) + '\n```'
+        : !content
+            ? emptyText
+            : '```json\n' + parseJsonWithComments(content) + '\n```';
+}
+function isCommentObject(obj) {
+    return (obj !== null &&
+        typeof obj === 'object' &&
+        '__comment' in obj &&
+        'value' in obj &&
+        Object.keys(obj).length === 2);
+}
+function parseJsonWithComments(obj, indent = 0) {
+    const indentStr = ' '.repeat(indent);
+    const nextIndentStr = ' '.repeat(indent + 3);
+    // Handle comment objects at the root level
+    if (isCommentObject(obj)) {
+        const commentLines = obj.__comment.split('\n');
+        const comments = commentLines.map(line => `${indentStr}// ${line}`).join('\n');
+        return comments + '\n' + parseJsonWithComments(obj.value, indent);
+    }
+    if (Array.isArray(obj)) {
+        if (obj.length === 0) {
+            return '[]';
+        }
+        let result = '[\n';
+        for (let i = 0; i < obj.length; i++) {
+            const item = obj[i];
+            if (isCommentObject(item)) {
+                // Add comment lines
+                const commentLines = item.__comment.split('\n');
+                commentLines.forEach(line => {
+                    result += `${nextIndentStr}// ${line}\n`;
+                });
+                // Add the actual value
+                result += `${nextIndentStr}${parseJsonWithComments(item.value, indent + 3)}`;
+            }
+            else {
+                result += `${nextIndentStr}${parseJsonWithComments(item, indent + 3)}`;
+            }
+            if (i < obj.length - 1) {
+                result += ',';
+            }
+            result += '\n';
+        }
+        result += `${indentStr}]`;
+        return result;
+    }
+    if (obj !== null && typeof obj === 'object') {
+        const keys = Object.keys(obj);
+        if (keys.length === 0) {
+            return '{}';
+        }
+        let result = '{\n';
+        const keyCount = keys.length;
+        let processedKeys = 0;
+        for (const key of keys) {
+            const value = obj[key];
+            if (isCommentObject(value)) {
+                // Add comment lines
+                const commentLines = value.__comment.split('\n');
+                commentLines.forEach(line => {
+                    result += `${nextIndentStr}// ${line}\n`;
+                });
+                // Add the key-value pair with quoted property name
+                result += `${nextIndentStr}${JSON.stringify(key)}: ${parseJsonWithComments(value.value, indent + 3)}`;
+            }
+            else {
+                // Quote the property name for valid JSON
+                result += `${nextIndentStr}${JSON.stringify(key)}: ${parseJsonWithComments(value, indent + 3)}`;
+            }
+            processedKeys++;
+            if (processedKeys < keyCount) {
+                result += ',';
+            }
+            result += '\n';
+        }
+        result += `${indentStr}}`;
+        return result;
+    }
+    // Handle primitive values
+    if (typeof obj === 'string') {
+        return JSON.stringify(obj);
+    }
+    else if (obj === undefined) {
+        return 'undefined';
+    }
+    else {
+        return JSON.stringify(obj);
+    }
+}

package/dist/utils/makeTextBlock.d.ts

@@ -0,0 +1 @@
+export declare function makeTextBlock(content: string, emptyText?: string): string;

package/dist/utils/makeTextBlock.js

@@ -0,0 +1,3 @@
+export function makeTextBlock(content, emptyText = 'No data') {
+    return !content?.length ? emptyText : '```text\n' + content + '\n```';
+}

package/dist/utils/makeTypescriptBlock.d.ts

@@ -0,0 +1 @@
+export declare function makeTypescriptBlock(content: string, lineNos?: boolean): string;

package/dist/utils/makeTypescriptBlock.js

@@ -0,0 +1,10 @@
+export function makeTypescriptBlock(content, lineNos = false) {
+    const lines = content
+        .split('\n')
+        .map((l, idx) => (lineNos ? contentLine(l, idx) : l))
+        .join('\n');
+    return '```typescript' + (lineNos ? ' showLineNumbers' : '') + '\n' + lines + '\n```';
+}
+function contentLine(line, idx) {
+    return `${(idx + 1).toString().padStart(4, ' ')}   ${line}`;
+}

package/dist/utils/mdAdjustHeadings.d.ts

@@ -0,0 +1 @@
+export declare function mdAdjustHeadings(md: string, topLevel: number): string;

package/dist/utils/mdAdjustHeadings.js

@@ -0,0 +1,27 @@
+export function mdAdjustHeadings(md, topLevel) {
+    // Split the prompt into lines for processing
+    const lines = md.split('\n');
+    const result = [];
+    // Process each line
+    for (let line of lines) {
+        // Check if the line is a heading (starts with one or more '#' characters)
+        const headingMatch = line.match(/^(#+)\s+(.*)/);
+        if (headingMatch) {
+            // Extract the heading level and content
+            const currentLevel = headingMatch[1].length;
+            const headingContent = headingMatch[2];
+            // Calculate the new heading level (original level + topLevel - 1)
+            // This ensures that level 1 headings become topLevel headings
+            const newLevel = currentLevel + topLevel - 1;
+            // Construct the new heading with the adjusted level
+            const newHeading = '#'.repeat(newLevel) + ' ' + headingContent;
+            result.push(newHeading);
+        }
+        else {
+            // Not a heading, keep the line as is
+            result.push(line);
+        }
+    }
+    // Join the lines back together and return
+    return result.join('\n');
+}

package/dist/utils/mergePrompts.d.ts

@@ -0,0 +1,7 @@
+import { Prompt } from '../types/index.js';
+export type MergePromptsOptions = {
+    joiner?: string;
+    title?: string;
+    level?: number;
+};
+export declare const mergePrompts: (prompts: Prompt[], o?: MergePromptsOptions) => Prompt;

package/dist/utils/mergePrompts.js

@@ -0,0 +1,17 @@
+import { makeH1 } from './makeH1.js';
+import { promptAdjustHeadings } from './promptAdjustHeadings.js';
+import { textJoin } from './textJoin.js';
+export const mergePrompts = (prompts, o = {}) => {
+    const { joiner = '', title, level = 1 } = o;
+    const texts = prompts.map(p => p.text).filter(Boolean);
+    const images = prompts
+        .map(p => p.images)
+        .filter(Boolean)
+        .flat();
+    return promptAdjustHeadings({
+        text: texts?.length
+            ? textJoin([title ? makeH1(title) : undefined, texts.join(joiner + '\n')])
+            : '',
+        images,
+    }, level);
+};

package/dist/utils/parseJson.d.ts

@@ -0,0 +1 @@
+export declare function parseJson<T = any>(json?: string): T | undefined;

package/dist/utils/parseJson.js

@@ -0,0 +1,11 @@
+import { Logger } from '@sjts/lib-log';
+import { jsonrepair } from 'jsonrepair';
+export function parseJson(json) {
+    try {
+        return JSON.parse(jsonrepair(json ?? '{}') ?? '{}');
+    }
+    catch (e) {
+        Logger.error('Error parsing JSON', { e, json });
+        return undefined;
+    }
+}

package/dist/utils/promptAdjustHeadings.d.ts

@@ -0,0 +1,2 @@
+import { Prompt } from '../types/index.js';
+export declare function promptAdjustHeadings(prompt: Prompt, topLevel: number): Prompt;

package/dist/utils/promptAdjustHeadings.js

@@ -0,0 +1,4 @@
+import { mdAdjustHeadings } from './mdAdjustHeadings.js';
+export function promptAdjustHeadings(prompt, topLevel) {
+    return { text: mdAdjustHeadings(prompt.text, topLevel), images: prompt.images };
+}

package/dist/utils/textJoin.d.ts

@@ -0,0 +1 @@
+export declare function textJoin(texts?: (string | undefined)[], joiner?: string): string;

package/dist/utils/textJoin.js

@@ -0,0 +1,3 @@
+export function textJoin(texts = [], joiner = '\n') {
+    return texts.filter(Boolean).join(joiner).trim();
+}

package/dist/utils/trim.d.ts

@@ -0,0 +1 @@
+export declare function trim(text: string): string;

package/dist/utils/trim.js

@@ -0,0 +1,5 @@
+export function trim(text) {
+    if (!text)
+        return '';
+    return text.trim();
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@sjts/ai-shared",
+  "description": "The Steve James Typescript AI Shared package",
+  "version": "30.2.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:clean": "yarn run clean && yarn run build",
+    "clean": "rm -rf dist",
+    "release:patch": "yarn version patch && yarn npm publish",
+    "release:minor": "yarn version minor && yarn npm publish",
+    "release:major": "yarn version major && yarn npm publish"
+  },
+  "prettier": "@sjts/lib-devops/prettier.json",
+  "dependencies": {
+    "@sjts/lib-log": "30.2.0",
+    "@sjts/lib-utils": "30.2.0",
+    "jsonrepair": "^3.7.0"
+  },
+  "devDependencies": {
+    "@sjts/lib-devops": "30.2.0",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}