@codebolt/agent 6.1.20 → 6.1.21

package/dist/unified/agent/agent.js

@@ -1,7 +1,12 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Agent = void 0;
 exports.createAgent = createAgent;
+const codeboltjs_1 = __importDefault(require("@codebolt/codeboltjs"));
+const crypto_1 = require("crypto");
 const base_1 = require("../base");
 const agentStep_1 = require("../base/agentStep");
 const responseExecutor_1 = require("../base/responseExecutor");
@@ -118,17 +123,24 @@ class Agent {
         this.maxTurns = (_l = (_k = config.maxTurns) !== null && _k !== void 0 ? _k : config.maxIterations) !== null && _l !== void 0 ? _l : 25;
         this.localToolSchemas = localToolRegistry.schemas;
         this.localToolsByExecutionName = localToolRegistry.byExecutionName;
+        this.runtimeToolSetId = `agent-${(0, crypto_1.randomUUID)()}`;
     }
     async run(message, options) {
         var _a, _b;
         try {
+            await this.registerRuntimeToolsForSearch();
             const reqMessage = typeof message === 'string'
                 ? createDefaultUserMessage(message)
                 : message;
             let prompt;
             const contextToUse = this.resolveRunContext(options);
             if (contextToUse) {
-                prompt = contextToUse;
+                const promptGenerator = new base_1.InitialPromptGenerator({
+                    processors: this.getResumeMessageModifiers(),
+                    initialPrompt: contextToUse,
+                    enableLogging: this.enableLogging
+                });
+                prompt = await promptGenerator.processMessage(reqMessage);
             }
             else {
                 const promptGenerator = new base_1.InitialPromptGenerator({
@@ -138,6 +150,7 @@ class Agent {
                 });
                 prompt = await promptGenerator.processMessage(reqMessage);
             }
+            prompt = await this.hydratePromptFromServerCompaction(reqMessage, prompt);
             let completed = false;
             let turnNumber = 0;
             let finalMessage;
@@ -224,6 +237,37 @@ class Agent {
                 error: errorMessage
             };
         }
+        finally {
+            await this.unregisterRuntimeToolsForSearch();
+        }
+    }
+    async registerRuntimeToolsForSearch() {
+        var _a, _b;
+        if (this.localToolSchemas.length === 0) {
+            return;
+        }
+        try {
+            await ((_b = (_a = codeboltjs_1.default.searchableAssets) === null || _a === void 0 ? void 0 : _a.registerRuntimeTools) === null || _b === void 0 ? void 0 : _b.call(_a, this.runtimeToolSetId, this.localToolSchemas));
+        }
+        catch (error) {
+            if (this.enableLogging) {
+                console.error('[Agent] Failed to register runtime tools for search:', error);
+            }
+        }
+    }
+    async unregisterRuntimeToolsForSearch() {
+        var _a, _b;
+        if (this.localToolSchemas.length === 0) {
+            return;
+        }
+        try {
+            await ((_b = (_a = codeboltjs_1.default.searchableAssets) === null || _a === void 0 ? void 0 : _a.unregisterRuntimeTools) === null || _b === void 0 ? void 0 : _b.call(_a, this.runtimeToolSetId));
+        }
+        catch (error) {
+            if (this.enableLogging) {
+                console.error('[Agent] Failed to unregister runtime tools for search:', error);
+            }
+        }
     }
     async processMessage(message, options) {
         return this.run(message, options);
@@ -259,6 +303,9 @@ class Agent {
         }
         return (_c = (_b = (_a = options.state) === null || _a === void 0 ? void 0 : _a.prompt) !== null && _b !== void 0 ? _b : options.context) !== null && _c !== void 0 ? _c : this.context;
     }
+    getResumeMessageModifiers() {
+        return this.messageModifiers.filter((modifier) => { var _a; return ((_a = modifier.constructor) === null || _a === void 0 ? void 0 : _a.name) !== 'ChatHistoryMessageModifier'; });
+    }
     isProcessedMessage(value) {
         return 'message' in value && 'metadata' in value;
     }
@@ -280,6 +327,111 @@ class Agent {
             },
         };
     }
+    async hydratePromptFromServerCompaction(requestMessage, prompt) {
+        if (!requestMessage.threadId) {
+            return prompt;
+        }
+        try {
+            const response = await codeboltjs_1.default.thread.getThreadContextCompacted({
+                threadId: requestMessage.threadId,
+            });
+            if (!this.isServerCompactionCurrent(response === null || response === void 0 ? void 0 : response.context)) {
+                return prompt;
+            }
+            const compactedMessages = this.extractServerCompactedMessages(response === null || response === void 0 ? void 0 : response.compactedContext);
+            if (compactedMessages.length === 0) {
+                return prompt;
+            }
+            const currentRunMessages = this.extractCurrentRunMessages(requestMessage, prompt);
+            return {
+                ...(0, promptContext_1.replaceTranscriptMessages)(prompt, [
+                    ...compactedMessages,
+                    ...currentRunMessages,
+                ]),
+                metadata: {
+                    ...prompt.metadata,
+                    serverCompaction: {
+                        threadId: requestMessage.threadId,
+                        timestamp: new Date().toISOString(),
+                        messageCount: compactedMessages.length,
+                        currentRunMessageCount: currentRunMessages.length,
+                    },
+                },
+            };
+        }
+        catch (error) {
+            if (this.enableLogging) {
+                console.error('[Agent] Failed to hydrate prompt from server compaction:', error);
+            }
+            return prompt;
+        }
+    }
+    isServerCompactionCurrent(context) {
+        if (!context || typeof context !== 'object') {
+            return true;
+        }
+        const metadata = context.metadata;
+        if (!metadata || typeof metadata !== 'object') {
+            return true;
+        }
+        const messageCount = Number(metadata.messageCount);
+        const lastCompactionMessageCount = Number(metadata.lastCompactionMessageCount);
+        if (!Number.isFinite(messageCount) || !Number.isFinite(lastCompactionMessageCount)) {
+            return true;
+        }
+        return messageCount <= lastCompactionMessageCount;
+    }
+    extractCurrentRunMessages(requestMessage, prompt) {
+        const transcriptMessages = (0, promptContext_1.getTranscriptMessages)(prompt);
+        const lastMessage = transcriptMessages[transcriptMessages.length - 1];
+        if (!lastMessage || lastMessage.role !== 'user') {
+            return [];
+        }
+        const requestedContent = requestMessage.userMessage || '';
+        if (!this.isCurrentRunUserMessage(lastMessage, requestedContent)) {
+            return [];
+        }
+        return [{ ...lastMessage }];
+    }
+    isCurrentRunUserMessage(message, requestedContent) {
+        if (typeof message.content === 'string') {
+            return message.content === requestedContent ||
+                message.content.startsWith(`${requestedContent}\n\n`);
+        }
+        if (!Array.isArray(message.content)) {
+            return false;
+        }
+        const firstTextPart = message.content.find((part) => !!part &&
+            typeof part === 'object' &&
+            !Array.isArray(part) &&
+            part.type === 'text' &&
+            typeof part.text === 'string');
+        return (firstTextPart === null || firstTextPart === void 0 ? void 0 : firstTextPart.text) === requestedContent ||
+            (firstTextPart === null || firstTextPart === void 0 ? void 0 : firstTextPart.text.startsWith(`${requestedContent}\n\n`)) ||
+            (requestedContent.length === 0 && (firstTextPart === null || firstTextPart === void 0 ? void 0 : firstTextPart.text) === 'Please use the attached image.');
+    }
+    extractServerCompactedMessages(compactedContext) {
+        var _a;
+        const data = typeof compactedContext === 'object' && compactedContext !== null
+            ? compactedContext.data
+            : undefined;
+        const messages = typeof data === 'object' && data !== null
+            ? ((_a = data.input) !== null && _a !== void 0 ? _a : data.messages)
+            : undefined;
+        if (!Array.isArray(messages)) {
+            return [];
+        }
+        return messages
+            .filter((message) => this.isServerCompactedMessage(message))
+            .map((message) => ({ ...message }));
+    }
+    isServerCompactedMessage(value) {
+        if (!value || typeof value !== 'object') {
+            return false;
+        }
+        const message = value;
+        return typeof message.role === 'string' && message.content !== undefined;
+    }
     async tryRecoverPrompt(prompt, error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         if (!this.compactionOrchestrator.getReactiveLayer().isRecoverableError(errorMessage)) {
@@ -370,35 +522,34 @@ class Agent {
         return this.allowedTools;
     }
     getRecoverableResponseError(response) {
-        var _a, _b, _c, _d;
+        var _a;
         const reactiveLayer = this.compactionOrchestrator.getReactiveLayer();
         const candidateMessages = this.collectResponseMessages(response);
         const recoverableMessage = candidateMessages.find((message) => reactiveLayer.isRecoverableError(message));
         if (recoverableMessage) {
             return recoverableMessage;
         }
-        const finishReasons = [
-            response.finish_reason,
-            ...((_a = response.choices) !== null && _a !== void 0 ? _a : []).map((choice) => choice.finish_reason),
-        ].filter((reason) => typeof reason === 'string');
+        const finishReasons = [response.finish_reason].filter((reason) => typeof reason === 'string');
         const hasLengthFinishReason = finishReasons.some((reason) => reason.toLowerCase() === 'length');
-        const hasToolCalls = ((_c = (_b = response.tool_calls) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) > 0 ||
-            ((_d = response.choices) !== null && _d !== void 0 ? _d : []).some((choice) => { var _a, _b, _c; return ((_c = (_b = (_a = choice.message) === null || _a === void 0 ? void 0 : _a.tool_calls) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) > 0; });
+        const hasToolCalls = ((_a = response.items) !== null && _a !== void 0 ? _a : []).some((item) => (item === null || item === void 0 ? void 0 : item.type) === 'function_call');
         if (hasLengthFinishReason && candidateMessages.length === 0 && !hasToolCalls) {
             return 'Too many tokens or token limit reached before producing usable output.';
         }
         return null;
     }
     collectResponseMessages(response) {
-        var _a, _b;
+        var _a;
         const messages = [];
-        if (typeof response.content === 'string' && response.content.trim().length > 0) {
-            messages.push(response.content.trim());
+        const outputText = response.output_text || response.content;
+        if (typeof outputText === 'string' && outputText.trim().length > 0) {
+            messages.push(outputText.trim());
         }
-        for (const choice of (_a = response.choices) !== null && _a !== void 0 ? _a : []) {
-            if (typeof ((_b = choice.message) === null || _b === void 0 ? void 0 : _b.content) === 'string' &&
-                choice.message.content.trim().length > 0) {
-                messages.push(choice.message.content.trim());
+        for (const item of (_a = response.items) !== null && _a !== void 0 ? _a : []) {
+            if ((item === null || item === void 0 ? void 0 : item.type) === 'message' && item.role === 'assistant') {
+                const content = item.content;
+                if (typeof content === 'string' && content.trim().length > 0) {
+                    messages.push(content.trim());
+                }
             }
         }
         return messages;

package/dist/unified/agent/tools.d.ts

@@ -31,6 +31,20 @@ export declare class Tool implements ToolInterface {
      * @returns OpenAI function specification
      */
     toOpenAITool(): OpenAITool;
+    private getZodDef;
+    private getZodTypeName;
+    private getZodDescription;
+    private applyDescription;
+    private withDescriptionFrom;
+    private getObjectShape;
+    /**
+     * Converts a Zod schema to JSON Schema format for OpenAI functions.
+     *
+     * The converter intentionally checks Zod's schema metadata instead of
+     * relying only on instanceof. Local tools are often created in another
+     * workspace package with its own zod module instance, which makes
+     * instanceof checks fail even though the schema is valid.
+     */
     private zodSchemaToJsonSchema;
     /**
      * Converts individual Zod types to JSON Schema

package/dist/unified/agent/tools.js

@@ -114,14 +114,54 @@ class Tool {
             }
         };
     }
-    // /**
-    //  * Converts a Zod schema to JSON Schema format for OpenAI functions
-    //  */
+    getZodDef(zodType) {
+        return (zodType._def || {});
+    }
+    getZodTypeName(zodType) {
+        const def = this.getZodDef(zodType);
+        return typeof def['typeName'] === 'string' ? def['typeName'] : undefined;
+    }
+    getZodDescription(zodType) {
+        const def = this.getZodDef(zodType);
+        return typeof def['description'] === 'string' ? def['description'] : undefined;
+    }
+    applyDescription(jsonSchema, zodType) {
+        const description = this.getZodDescription(zodType);
+        if (description) {
+            jsonSchema['description'] = description;
+        }
+    }
+    withDescriptionFrom(jsonSchema, zodType) {
+        if (jsonSchema && typeof jsonSchema === 'object' && !Array.isArray(jsonSchema)) {
+            this.applyDescription(jsonSchema, zodType);
+        }
+        return jsonSchema;
+    }
+    getObjectShape(zodType) {
+        const directShape = zodType.shape;
+        if (directShape && typeof directShape === 'object') {
+            return directShape;
+        }
+        const defShape = this.getZodDef(zodType)['shape'];
+        if (typeof defShape === 'function') {
+            return defShape();
+        }
+        if (defShape && typeof defShape === 'object') {
+            return defShape;
+        }
+        return {};
+    }
+    /**
+     * Converts a Zod schema to JSON Schema format for OpenAI functions.
+     *
+     * The converter intentionally checks Zod's schema metadata instead of
+     * relying only on instanceof. Local tools are often created in another
+     * workspace package with its own zod module instance, which makes
+     * instanceof checks fail even though the schema is valid.
+     */
     zodSchemaToJsonSchema(schema) {
-        // This is a simplified conversion - in a real implementation,
-        // you might want to use a library like zod-to-json-schema
-        if (schema instanceof zod_1.z.ZodObject) {
-            const shape = schema.shape;
+        if (schema instanceof zod_1.z.ZodObject || this.getZodTypeName(schema) === 'ZodObject') {
+            const shape = this.getObjectShape(schema);
             const properties = {};
             const required = [];
             for (const [key, value] of Object.entries(shape)) {
@@ -131,12 +171,14 @@ class Tool {
                     required.push(key);
                 }
             }
-            return {
+            const result = {
                 type: 'object',
                 properties,
                 required: required.length > 0 ? required : undefined,
                 additionalProperties: false
             };
+            this.applyDescription(result, schema);
+            return result;
         }
         return this.zodTypeToJsonSchema(schema);
     }
@@ -144,14 +186,12 @@ class Tool {
      * Converts individual Zod types to JSON Schema
      */
     zodTypeToJsonSchema(zodType) {
-        if (zodType instanceof zod_1.z.ZodString) {
+        const typeName = this.getZodTypeName(zodType);
+        if (zodType instanceof zod_1.z.ZodString || typeName === 'ZodString') {
             const result = { type: 'string' };
-            // Add description if available
-            if (zodType._def.description) {
-                result.description = zodType._def.description;
-            }
+            this.applyDescription(result, zodType);
             // Add constraints
-            const checks = zodType._def.checks || [];
+            const checks = this.getZodDef(zodType)['checks'] || [];
             for (const check of checks) {
                 switch (check.kind) {
                     case 'min':
@@ -173,12 +213,10 @@ class Tool {
             }
             return result;
         }
-        if (zodType instanceof zod_1.z.ZodNumber) {
+        if (zodType instanceof zod_1.z.ZodNumber || typeName === 'ZodNumber') {
             const result = { type: 'number' };
-            if (zodType._def.description) {
-                result.description = zodType._def.description;
-            }
-            const checks = zodType._def.checks || [];
+            this.applyDescription(result, zodType);
+            const checks = this.getZodDef(zodType)['checks'] || [];
             for (const check of checks) {
                 switch (check.kind) {
                     case 'min':
@@ -194,22 +232,18 @@ class Tool {
             }
             return result;
         }
-        if (zodType instanceof zod_1.z.ZodBoolean) {
+        if (zodType instanceof zod_1.z.ZodBoolean || typeName === 'ZodBoolean') {
             const result = { type: 'boolean' };
-            if (zodType._def.description) {
-                result.description = zodType._def.description;
-            }
+            this.applyDescription(result, zodType);
             return result;
         }
-        if (zodType instanceof zod_1.z.ZodArray) {
+        if (zodType instanceof zod_1.z.ZodArray || typeName === 'ZodArray') {
             const result = {
                 type: 'array',
-                items: this.zodTypeToJsonSchema(zodType._def.type)
+                items: this.zodTypeToJsonSchema(this.getZodDef(zodType)['type'])
             };
-            if (zodType._def.description) {
-                result.description = zodType._def.description;
-            }
-            const checks = zodType._def.checks || [];
+            this.applyDescription(result, zodType);
+            const checks = this.getZodDef(zodType)['checks'] || [];
             for (const check of checks) {
                 switch (check.kind) {
                     case 'min':
@@ -222,48 +256,45 @@ class Tool {
             }
             return result;
         }
-        if (zodType instanceof zod_1.z.ZodEnum) {
+        if (zodType instanceof zod_1.z.ZodEnum || typeName === 'ZodEnum') {
             const result = {
                 type: 'string',
-                enum: zodType._def.values
+                enum: this.getZodDef(zodType)['values']
             };
-            if (zodType._def.description) {
-                result.description = zodType._def.description;
-            }
+            this.applyDescription(result, zodType);
             return result;
         }
-        if (zodType instanceof zod_1.z.ZodLiteral) {
+        if (zodType instanceof zod_1.z.ZodLiteral || typeName === 'ZodLiteral') {
+            const value = this.getZodDef(zodType)['value'];
             const result = {
-                type: typeof zodType._def.value,
-                enum: [zodType._def.value]
+                type: typeof value,
+                enum: [value]
             };
-            if (zodType._def.description) {
-                result.description = zodType._def.description;
-            }
+            this.applyDescription(result, zodType);
             return result;
         }
-        if (zodType instanceof zod_1.z.ZodUnion) {
-            const options = zodType._def.options;
+        if (zodType instanceof zod_1.z.ZodUnion || typeName === 'ZodUnion') {
+            const options = this.getZodDef(zodType)['options'] || [];
             const anyOf = options.map((option) => this.zodTypeToJsonSchema(option));
             const result = { anyOf };
-            if (zodType._def.description) {
-                result.description = zodType._def.description;
-            }
+            this.applyDescription(result, zodType);
             return result;
         }
-        if (zodType instanceof zod_1.z.ZodOptional) {
-            return this.zodTypeToJsonSchema(zodType._def.innerType);
+        if (zodType instanceof zod_1.z.ZodOptional || typeName === 'ZodOptional') {
+            return this.withDescriptionFrom(this.zodTypeToJsonSchema(this.getZodDef(zodType)['innerType']), zodType);
         }
-        if (zodType instanceof zod_1.z.ZodNullable) {
-            const innerSchema = this.zodTypeToJsonSchema(zodType._def.innerType);
-            return {
+        if (zodType instanceof zod_1.z.ZodNullable || typeName === 'ZodNullable') {
+            const innerSchema = this.zodTypeToJsonSchema(this.getZodDef(zodType)['innerType']);
+            const result = {
                 anyOf: [
                     innerSchema,
                     { type: 'null' }
                 ]
             };
+            this.applyDescription(result, zodType);
+            return result;
         }
-        if (zodType instanceof zod_1.z.ZodObject) {
+        if (zodType instanceof zod_1.z.ZodObject || typeName === 'ZodObject') {
             return this.zodSchemaToJsonSchema(zodType);
         }
         // Fallback for unknown types

package/dist/unified/base/agentStep.d.ts

@@ -17,6 +17,7 @@ export declare class AgentStep implements AgentStepInterface {
      */
     executeStep(originalRequest: FlatUserMessage, createdMessage: ProcessedMessage): Promise<AgentStepOutput>;
     private generateResponse;
+    private extractCompletion;
     /**
      * Update LLM configuration
      */

package/dist/unified/base/agentStep.js

@@ -36,11 +36,11 @@ class AgentStep {
                 message: (0, promptContext_1.buildInferenceParams)(preparedMessage),
             };
             const rawLLMResponse = await this.generateResponse(actualMessageSentToLLM.message);
-            const assistantMessages = ((_a = rawLLMResponse.choices) !== null && _a !== void 0 ? _a : []).map((contentBlock) => ({
-                ...contentBlock.message,
-                role: contentBlock.message.role
-            }));
-            let modifiedMessage = (0, promptContext_1.appendTranscriptMessages)(preparedMessage, assistantMessages);
+            const assistantResponseItems = ((_a = rawLLMResponse.items) !== null && _a !== void 0 ? _a : [])
+                .filter((item) => (((item === null || item === void 0 ? void 0 : item.type) === 'message' && item.role === 'assistant') ||
+                (item === null || item === void 0 ? void 0 : item.type) === 'function_call' ||
+                (item === null || item === void 0 ? void 0 : item.type) === 'tool_search_call'));
+            let modifiedMessage = (0, promptContext_1.appendTranscriptMessages)(preparedMessage, assistantResponseItems);
             for (const postInferenceProcessor of this.postInferenceProcessors) {
                 try {
                     modifiedMessage = await postInferenceProcessor.modify(actualMessageSentToLLM, rawLLMResponse, modifiedMessage);
@@ -63,9 +63,14 @@ class AgentStep {
         }
     }
     async generateResponse(messageForLLM) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         const response = await codeboltjs_1.default.llm.inference(messageForLLM);
-        const completion = response.completion;
+        const completion = this.extractCompletion(response);
+        if (!completion) {
+            const responseType = (response === null || response === void 0 ? void 0 : response.type) || 'unknown';
+            const responseMessage = (response === null || response === void 0 ? void 0 : response.message) || ((_a = response === null || response === void 0 ? void 0 : response.error) === null || _a === void 0 ? void 0 : _a.message) || 'No completion returned from LLM service';
+            throw new Error(`LLM response did not include completion data (${responseType}): ${responseMessage}`);
+        }
         // Add tokenLimit and maxOutputTokens to completion object if available in response
         if (completion) {
             // Check if tokenLimit exists at response level or in completion
@@ -82,21 +87,44 @@ class AgentStep {
                 completion.compactionRequired = response.compactionRequired;
             }
             // Also check inside completion object itself (from LLM provider response)
-            if (((_a = completion.completion) === null || _a === void 0 ? void 0 : _a.tokenLimit) !== undefined) {
+            if (((_b = completion.completion) === null || _b === void 0 ? void 0 : _b.tokenLimit) !== undefined) {
                 completion.tokenLimit = completion.completion.tokenLimit;
             }
-            if (((_b = completion.completion) === null || _b === void 0 ? void 0 : _b.maxOutputTokens) !== undefined) {
+            if (((_c = completion.completion) === null || _c === void 0 ? void 0 : _c.maxOutputTokens) !== undefined) {
                 completion.maxOutputTokens = completion.completion.maxOutputTokens;
             }
-            if (((_c = completion.completion) === null || _c === void 0 ? void 0 : _c.contextCompaction) !== undefined) {
+            if (((_d = completion.completion) === null || _d === void 0 ? void 0 : _d.contextCompaction) !== undefined) {
                 completion.contextCompaction = completion.completion.contextCompaction;
             }
-            if (((_d = completion.completion) === null || _d === void 0 ? void 0 : _d.compactionRequired) !== undefined) {
+            if (((_e = completion.completion) === null || _e === void 0 ? void 0 : _e.compactionRequired) !== undefined) {
                 completion.compactionRequired = completion.completion.compactionRequired;
             }
         }
         return completion;
     }
+    extractCompletion(response) {
+        if (!response || typeof response !== 'object') {
+            return undefined;
+        }
+        if (response.completion && typeof response.completion === 'object') {
+            return response.completion;
+        }
+        if (Array.isArray(response.items) || typeof response.output_text === 'string') {
+            return {
+                ...response,
+                items: Array.isArray(response.items) ? response.items : [],
+                output_text: response.output_text || response.message || response.content || '',
+            };
+        }
+        if (typeof response.message === 'string' || typeof response.content === 'string') {
+            return {
+                ...response,
+                items: [],
+                output_text: response.message || response.content || '',
+            };
+        }
+        return undefined;
+    }
     /**
      * Update LLM configuration
      */

package/dist/unified/base/initialPromptGenerator.d.ts

@@ -8,9 +8,11 @@ export declare class InitialPromptGenerator implements InitialPromptGeneratorInt
     private metaData;
     private enableLogging;
     private baseSystemPrompt?;
+    private initialPrompt?;
     constructor(options?: {
         processors?: MessageModifier[];
         baseSystemPrompt?: string;
+        initialPrompt?: ProcessedMessage;
         metaData?: Record<string, unknown>;
         enableLogging?: boolean;
         templating?: boolean;