agentlang 0.10.1 → 0.10.3

package/out/runtime/modules/ai.d.ts

@@ -6,6 +6,12 @@ export declare const CoreAIModuleName: string;
 export declare const AgentEntityName = "Agent";
 export declare const LlmEntityName = "LLM";
 export declare const AgentLearnerType = "learner";
+export declare class AgentCancelledException extends Error {
+    constructor(chatId: string);
+}
+export declare function cancelAgent(chatId: string): Promise<string>;
+export declare function checkCancelled(chatId: string): Promise<void>;
+export declare function clearCancellation(chatId: string): Promise<void>;
 declare const _default: string;
 export default _default;
 declare enum AgentCacheType {
@@ -23,12 +29,14 @@ export declare class AgentInstance {
     type: string;
     tools: string | undefined;
     documents: string | undefined;
+    topics: string | undefined;
     channels: string | undefined;
     runWorkflows: boolean;
     role: string | undefined;
     flows: string | undefined;
     validate: string | undefined;
     retry: string | undefined;
+    saveResponseAs: string | undefined;
     stateless: boolean;
     private toolsArray;
     private hasModuleTools;
@@ -64,8 +72,9 @@ export declare class AgentInstance {
     static ResetCache(fqName: string, type: AgentCacheType): void;
     private getFullInstructionsHelper;
     private static UserTag;
+    private static FileTag;
     private getFullInstructions;
-    private static maybeRewriteTemplatePatterns;
+    private maybeFillInFileContents;
     maybeValidateJsonResponse(response: string | undefined): object | undefined;
     getFqName(): string;
     markAsFlowExecutor(): AgentInstance;
@@ -81,8 +90,7 @@ export declare class AgentInstance {
     private getValidationEvent;
     private getExternalToolSpecs;
     private maybeAddRelevantDocuments;
-    private static docTitlesMatch;
-    private static getDocumentTitle;
+    private queryRemoteKnowledgeService;
     private static ToolsCache;
     private toolsAsString;
 }
@@ -93,11 +101,14 @@ export declare function saveAgentChatSession(chatId: string, messages: any[], en
 export declare function agentName(agentInstance: Instance): string;
 export declare function normalizeGeneratedCode(code: string | undefined): string;
 export declare function processAgentLearning(moduleName: string, agentName: string, instruction: string, env: Environment): Promise<any>;
-export declare function saveFlowStepResultLocally(chatId: string, step: string, result: string, suspensionId: string): Promise<Instance | undefined>;
-export declare function saveFlowStepResult(chatId: string, step: string, result: string, suspensionId: string, env: Environment): Promise<Instance | undefined>;
+export declare function saveFlowStepResultLocally(chatId: string, step: string, result: string, suspensionId?: string | undefined): Promise<string>;
+export declare function saveFlowStepResult(chatId: string, step: string, result: string, suspensionId: string, env: Environment): Promise<boolean>;
 export declare function loadLocalFlowStepResults(chatId: string): Promise<Instance[]>;
 export declare function loadFlowStepResults(chatId: string): Promise<Instance[]>;
+export declare function loadLocalAgentResult(chatId: string, step: string): Promise<string | undefined>;
 export declare function loadLocalFlowStep(chatId: string, step: string): Promise<Instance | undefined>;
 export declare function loadFlowStep(chatId: string, step: string): Promise<Instance | undefined>;
+export declare function registerTopic(name: string, documents: string | undefined, _env: Environment): Promise<any>;
 export declare function fetchAndCreateDocument(title: string, url: string, retrievalConfig: Map<string, any> | undefined, embeddingConfig: Map<string, any> | undefined, _env: Environment): Promise<any>;
+export declare function saveAgentResponse(fileName: string, response: string, env: Environment): Promise<string>;
 //# sourceMappingURL=ai.d.ts.map

package/out/runtime/modules/ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../src/runtime/modules/ai.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../src/runtime/modules/ai.ts"],"names":[],"mappings":"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"}

package/out/runtime/modules/ai.js

@@ -1,20 +1,58 @@
 import { DefaultModuleName, escapeSpecialChars, extractAndRemoveAllXmlTaggedText, extractFencedCodeBlocks, isFqName, isString, makeCoreModuleName, makeFqName, nameToPath, restoreSpecialChars, sleepMilliseconds, splitFqName, } from '../util.js';
 import { GlobalEnvironment, makeEventEvaluator, parseAndEvaluateStatement, } from '../interpreter.js';
-import { Agent, asJSONSchema, fetchModule, getDecision, getGlobalRetry, Instance, instanceToObject, isAgent, isInstanceOfType, isModule, makeInstance, newInstanceAttributes, objectToInstanceAttributes, Record, resolveDocumentAliases, } from '../module.js';
+import { Agent, asJSONSchema, fetchModule, getAllDocumentsForTopics, getDecision, getGlobalRetry, Instance, instanceToObject, isAgent, isInstanceOfType, isModule, makeInstance, newInstanceAttributes, objectToInstanceAttributes, Record, registerTopic as registerTopicInRegistry, resolveDocumentAliases, resolveTopicNames, } from '../module.js';
 import { provider } from '../agents/registry.js';
 import { assistantMessage, humanMessage, systemMessage, } from '../agents/provider.js';
 import { AIMessage, HumanMessage, SystemMessage } from '@langchain/core/messages';
 import { DecisionAgentInstructions, EvalInstructions, FlowExecInstructions, getAgentDirectives, getAgentGlossary, getAgentResponseSchema, getAgentScenarios, getAgentScratchNames, LearningAgentInstructions as LearnerAgentInstructions, newAgentDirective, newAgentGlossaryEntry, newAgentScenario, PlannerInstructions, } from '../agents/common.js';
 import { logger } from '../logger.js';
-import Handlebars from 'handlebars';
-import { isMonitoringEnabled, TtlCache } from '../state.js';
+import { getKnowledgeGraphConfig, isMonitoringEnabled, TtlCache } from '../state.js';
 import { isNodeEnv } from '../../utils/runtime.js';
 import { getFileSystem } from '../../utils/fs-utils.js';
+import { getDocumentRetriever } from '../document-retriever.js';
 export const CoreAIModuleName = makeCoreModuleName('ai');
 export const AgentEntityName = 'Agent';
 export const LlmEntityName = 'LLM';
 export const AgentLearnerType = 'learner';
 const AgentEvalType = 'eval';
+// --- Agent cancellation infrastructure ---
+export class AgentCancelledException extends Error {
+    constructor(chatId) {
+        super(`Agent cancelled for chatId: ${chatId}`);
+        this.name = 'AgentCancelledException';
+    }
+}
+export async function cancelAgent(chatId) {
+    const t = `${CoreAIModuleName}/${CancelledAgentEntity}`;
+    await parseAndEvaluateStatement(`{${t} {chatId "${chatId}"}, @upsert}`);
+    return `Cancellation requested for chatId: ${chatId}`;
+}
+export async function checkCancelled(chatId) {
+    if (!chatId)
+        return;
+    try {
+        const results = await parseAndEvaluateStatement(`{${CoreAIModuleName}/${CancelledAgentEntity} {chatId? "${chatId}"}}`);
+        if (results && results.length > 0) {
+            await parseAndEvaluateStatement(`purge {${CoreAIModuleName}/${CancelledAgentEntity} {chatId? "${chatId}"}}`);
+            throw new AgentCancelledException(chatId);
+        }
+    }
+    catch (err) {
+        if (err instanceof AgentCancelledException)
+            throw err;
+        logger.debug(`checkCancelled DB error for ${chatId}: ${err}`);
+    }
+}
+export async function clearCancellation(chatId) {
+    if (!chatId)
+        return;
+    try {
+        await parseAndEvaluateStatement(`purge {${CoreAIModuleName}/${CancelledAgentEntity} {chatId? "${chatId}"}}`);
+    }
+    catch (err) {
+        logger.debug(`clearCancellation DB error for ${chatId}: ${err}`);
+    }
+}
 export default `module ${CoreAIModuleName}
 
 import "./modules/ai.js" @as ai
@@ -33,12 +71,14 @@ entity ${AgentEntityName} {
     stateless Boolean @default(false),
     instruction String @optional,
     tools String @optional, // comma-separated list of tool names
-    documents String @optional, // comma-separated list of document names
+    documents String @optional, // list of document names
+    topics String @optional, // list of topic names
     channels String @optional, // comma-separated list of channel names
     role String @optional,
     flows String @optional,
     validate String @optional,
     retry String @optional,
+    saveResponseAs String @optional,
     llm String
 }
 
@@ -79,6 +119,15 @@ workflow processDoc {
   await ai.fetchAndCreateDocument(doc.title, doc.url, doc.retrievalConfig, doc.embeddingConfig)
 }
 
+event topic {
+  name String,
+  documents String @optional // comma-separated or array of document titles
+}
+
+workflow processTopic {
+  await ai.registerTopic(topic.name, topic.documents)
+}
+
 entity Directive {
   id UUID @id @default(uuid()),
   agentFqName String @indexed,
@@ -134,6 +183,10 @@ entity AgentFlowStep {
     suspensionId String
 }
 
+entity CancelledAgent {
+    chatId String @id
+}
+
 @public event restartFlow {
   chatId String,
   step String,
@@ -146,6 +199,14 @@ workflow restartFlow {
     {${DefaultModuleName}/restartSuspension {id fs.suspensionId, data restartFlow.userInput}}
   }
 }
+
+@public event cancelAgent {
+  chatId String
+}
+
+workflow cancelAgent {
+  await ai.cancelAgent(cancelAgent.chatId)
+}
 `;
 var AgentCacheType;
 (function (AgentCacheType) {
@@ -462,7 +523,7 @@ Only return a pure JSON object with no extra text, annotations etc.`;
         const spad = env.getScratchPad();
         if (spad !== undefined && Object.keys(spad).length > 0) {
             if (finalInstruction.indexOf('{{') > 0) {
-                return AgentInstance.maybeRewriteTemplatePatterns(spad, finalInstruction, env);
+                return env.maybeRewriteTemplatePatterns(finalInstruction, spad);
             }
             else {
                 const ctx = JSON.stringify(spad);
@@ -483,9 +544,22 @@ Only return a pure JSON object with no extra text, annotations etc.`;
             return { extracted: undefined, updatedText: finalInstruction };
         }
     }
-    static maybeRewriteTemplatePatterns(scratchPad, instruction, env) {
-        const templ = Handlebars.compile(env.rewriteTemplateMappings(instruction));
-        return templ(scratchPad);
+    async maybeFillInFileContents(instructions, env) {
+        const chatId = env.getActiveChatId();
+        const FC = '$FC';
+        if (chatId && instructions.indexOf(`<${AgentInstance.FileTag}>`) > 0) {
+            const ext = extractAndRemoveAllXmlTaggedText(instructions, AgentInstance.FileTag, FC);
+            if (ext.extracted) {
+                instructions = ext.updatedText;
+                for (let i = 0; i < ext.extracted.length; ++i) {
+                    const fileName = ext.extracted[i];
+                    const contents = await loadLocalAgentResult(chatId, fileName);
+                    if (contents)
+                        instructions = instructions.replace(FC, contents);
+                }
+            }
+        }
+        return instructions;
     }
     maybeValidateJsonResponse(response) {
         if (response) {
@@ -600,6 +674,7 @@ Only return a pure JSON object with no extra text, annotations etc.`;
         const p = await findProviderForLLM(this.llm, env);
         const agentName = this.name;
         const chatId = env.getAgentChatId() || agentName;
+        await checkCancelled(chatId);
         let isplnr = this.isPlanner();
         const isflow = !isplnr && this.isFlowExecutor();
         const iseval = !isplnr && !isflow && this.isEvaluator();
@@ -664,7 +739,8 @@ Only return a pure JSON object with no extra text, annotations etc.`;
                 }
                 let tmpMsg = message;
                 if (extractedText === null || extractedText === void 0 ? void 0 : extractedText.extracted) {
-                    tmpMsg = `${tmpMsg}\n${extractedText.extracted.join('\n')}`;
+                    const s = await this.maybeFillInFileContents(extractedText.extracted.join('\n'), env);
+                    tmpMsg = `${tmpMsg}\n${s}`;
                 }
                 const hmsg = await this.maybeAddRelevantDocuments(this.maybeAddFlowContext(tmpMsg, env), env);
                 if (hmsg.length > 0) {
@@ -693,7 +769,7 @@ Only return a pure JSON object with no extra text, annotations etc.`;
                 let response = await p.invoke(msgs, externalToolSpecs);
                 const v = this.getValidationEvent();
                 if (v) {
-                    response = await this.handleValidation(response, v, msgs, p);
+                    response = await this.handleValidation(response, v, msgs, p, chatId);
                 }
                 if (!iseval)
                     await AgentInstance.maybeEvaluateResponse(this, message, msgsContent, response.content, env);
@@ -706,6 +782,13 @@ Only return a pure JSON object with no extra text, annotations etc.`;
                 }
                 if (monitoringEnabled)
                     env.setMonitorEntryLlmResponse(response.content);
+                if (monitoringEnabled && response.sysMsg.usage_metadata) {
+                    const u = response.sysMsg.usage_metadata;
+                    env.setMonitorEntryLlmTokenUsage(u.input_tokens, u.output_tokens, u.total_tokens);
+                }
+                if (this.saveResponseAs) {
+                    await saveAgentResponse(this.saveResponseAs, response.content, env);
+                }
                 env.setLastResult(response.content);
             }
             catch (err) {
@@ -760,7 +843,7 @@ Only return a pure JSON object with no extra text, annotations etc.`;
             return r;
         }
     }
-    async handleValidation(response, validationEventName, msgs, provider) {
+    async handleValidation(response, validationEventName, msgs, provider, chatId) {
         let r = await this.invokeValidator(response, validationEventName);
         const status = r.lookup('status');
         if (status === 'ok') {
@@ -772,6 +855,8 @@ Only return a pure JSON object with no extra text, annotations etc.`;
                 let attempt = 0;
                 let delay = this.retryObj.getNextDelayMs(attempt);
                 while (delay) {
+                    if (chatId)
+                        await checkCancelled(chatId);
                     msgs.push(assistantMessage(resp.content));
                     const vs = JSON.stringify(r.asSerializableObject());
                     msgs.push(humanMessage(`Validation for your last response failed with this result: \n${vs}\n\nFix the errors.`));
@@ -816,77 +901,106 @@ Only return a pure JSON object with no extra text, annotations etc.`;
         }
         return result;
     }
-    async maybeAddRelevantDocuments(message, env) {
-        if (this.documents && this.documents.length > 0) {
-            try {
-                const docNames = this.documents.split(',').map(d => d.trim());
-                const docTitles = resolveDocumentAliases(docNames);
-                const searchQuery = message;
-                try {
-                    const semanticResult = await parseHelper(`{${CoreAIModuleName}/Document {content? "${searchQuery.replace(/"/g, '\\"')}"}}`, env);
-                    if (semanticResult && semanticResult.length > 0) {
-                        const docs = [];
-                        for (const doc of semanticResult) {
-                            const docTitle = doc.lookup ? doc.lookup('title') : doc.title;
-                            if (AgentInstance.docTitlesMatch(docTitle, docTitles)) {
-                                docs.push(doc instanceof Instance
-                                    ? doc
-                                    : Instance.newWithAttributes(doc, new Map(Object.entries(doc))));
-                            }
-                        }
-                        if (docs.length > 0) {
-                            return message.concat('\n\nRelevant context from documents:\n').concat(docs
-                                .map((v) => {
-                                return `Document: ${v.lookup('title')}\n${v.lookup('content')}`;
-                            })
-                                .join('\n\n---\n\n'));
-                        }
-                    }
-                }
-                catch (semanticErr) {
-                    logger.debug(`Semantic search is not available, falling back to title-based filtering: ${semanticErr}`);
-                }
-                const result = await parseHelper(`{${CoreAIModuleName}/Document? {}}`, env);
-                if (result && result.length > 0) {
-                    const docs = [];
-                    for (let i = 0; i < result.length; ++i) {
-                        const v = result[i];
-                        const docTitle = AgentInstance.getDocumentTitle(v);
-                        if (docTitle && docTitles.includes(docTitle)) {
-                            if (v instanceof Instance) {
-                                docs.push(v);
-                            }
-                        }
-                    }
-                    if (docs.length > 0) {
-                        return message.concat('\n\nRelevant context from documents:\n').concat(docs
-                            .map((v) => {
-                            return v.lookup('content');
-                        })
-                            .join('\n\n'));
+    async maybeAddRelevantDocuments(message, _env) {
+        var _a;
+        const hasDocuments = this.documents && this.documents.length > 0;
+        const hasTopics = this.topics && this.topics.length > 0;
+        if (!hasDocuments && !hasTopics) {
+            return message;
+        }
+        try {
+            let containerTags = [];
+            let topicDocumentTitles = [];
+            if (hasTopics) {
+                const topicNames = resolveTopicNames(this.topics);
+                containerTags = topicNames;
+                topicDocumentTitles = getAllDocumentsForTopics(topicNames);
+            }
+            if (containerTags.length === 0) {
+                containerTags = [this.getFqName()];
+            }
+            let documentTitles = [];
+            let documentRefs = [];
+            if (hasDocuments) {
+                const documentEntries = this.documents.split(',')
+                    .map(d => d.trim())
+                    .filter(Boolean);
+                documentTitles = resolveDocumentAliases(documentEntries);
+                documentRefs = documentEntries.filter(d => d.startsWith('document-service://'));
+            }
+            const allDocumentTitles = [...new Set([...topicDocumentTitles, ...documentTitles])];
+            const kgConfig = getKnowledgeGraphConfig();
+            const serviceUrl = ((_a = kgConfig === null || kgConfig === void 0 ? void 0 : kgConfig.serviceUrl) === null || _a === void 0 ? void 0 : _a.trim()) || process.env.KNOWLEDGE_SERVICE_URL || null;
+            if (serviceUrl) {
+                return await this.queryRemoteKnowledgeService(message, serviceUrl, containerTags, allDocumentTitles, documentRefs);
+            }
+            // Local mode: embed documents into pgvector/lancedb and query
+            const retriever = getDocumentRetriever();
+            const aiModule = isModule(DefaultModuleName + '.ai')
+                ? fetchModule(DefaultModuleName + '.ai')
+                : null;
+            if (aiModule) {
+                for (const title of allDocumentTitles) {
+                    const url = aiModule.getDocument(title);
+                    if (url) {
+                        await retriever.processDocument(title, url);
                     }
                 }
             }
-            catch (err) {
-                logger.debug(`Error retrieving documents: ${err}`);
+            const contextString = await retriever.query(message, allDocumentTitles.length > 0 ? allDocumentTitles : undefined, 10);
+            if (contextString.trim().length > 0) {
+                return message.concat('\n\nRelevant context from documents:\n').concat(contextString);
             }
         }
+        catch (err) {
+            logger.debug(`[KNOWLEDGE] Knowledge retrieval failed: ${err}`);
+        }
         return message;
     }
-    static docTitlesMatch(title, docNames) {
-        return title !== undefined && docNames.includes(title);
-    }
-    static getDocumentTitle(doc) {
-        if (typeof doc.lookup === 'function') {
-            return doc.lookup('title');
-        }
-        else if (doc.attributes) {
-            return doc.attributes.get('title');
+    async queryRemoteKnowledgeService(message, serviceUrl, containerTags, documentTitles, documentRefs) {
+        const options = {
+            chunkLimit: 10,
+            entityLimit: 20,
+            includeChunks: true,
+            includeEntities: true,
+            includeEdges: true,
+            documentTitles: documentTitles.length > 0 ? documentTitles : undefined,
+            documentRefs: documentRefs.length > 0 ? documentRefs : undefined,
+        };
+        let response = await fetch(`${serviceUrl}/api/knowledge/query`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(Object.assign({ query: message, containerTags }, options)),
+        });
+        if (!response.ok) {
+            response = await fetch(`${serviceUrl}/knowledge.core/ApiKnowledgeQuery`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    queryText: message,
+                    containerTagsJson: JSON.stringify(containerTags),
+                    documentTitlesJson: JSON.stringify(options.documentTitles || []),
+                    documentRefsJson: JSON.stringify(options.documentRefs || []),
+                    optionsJson: JSON.stringify({
+                        includeChunks: options.includeChunks,
+                        includeEntities: options.includeEntities,
+                        includeEdges: options.includeEdges,
+                        chunkLimit: options.chunkLimit,
+                        entityLimit: options.entityLimit,
+                    }),
+                }),
+            });
         }
-        else if (doc.title) {
-            return doc.title;
+        if (response.ok) {
+            const rawPayload = await response.json();
+            const first = Array.isArray(rawPayload) ? rawPayload[0] : rawPayload;
+            const payload = first && typeof first === 'object' && first.KnowledgeQuery ? first.KnowledgeQuery : first;
+            const contextString = (payload === null || payload === void 0 ? void 0 : payload.contextString) || '';
+            if (contextString.trim().length > 0) {
+                return message.concat('\n\nRelevant context from documents:\n').concat(contextString);
+            }
         }
-        return undefined;
+        return message;
     }
     toolsAsString() {
         const cachedTools = AgentInstance.ToolsCache.get(this.name);
@@ -942,6 +1056,7 @@ AgentInstance.GlossaryCache = new TtlCache(AgentInstance.CACHE_TTL_MS);
 AgentInstance.SummariesCache = new TtlCache(AgentInstance.CACHE_TTL_MS);
 AgentInstance.ScenariosCache = new TtlCache(AgentInstance.CACHE_TTL_MS);
 AgentInstance.UserTag = 'user';
+AgentInstance.FileTag = 'file';
 AgentInstance.AgentEvaluators = new Map();
 AgentInstance.ToolsCache = new Map();
 function extractScratchData(scratchNames, inst) {
@@ -1147,14 +1262,9 @@ export async function processAgentLearning(moduleName, agentName, instruction, e
 const LocalAgentgFlow = true;
 const LocalFlowStepsRootDirName = 'flows';
 const AgentFlowStep = 'AgentFlowStep';
+const CancelledAgentEntity = 'CancelledAgent';
 export async function saveFlowStepResultLocally(chatId, step, result, suspensionId) {
     const fs = await getFileSystem();
-    const attrs = newInstanceAttributes()
-        .set('chatId', chatId)
-        .set('step', step)
-        .set('result', result)
-        .set('suspensionId', suspensionId);
-    const inst = makeInstance(CoreAIModuleName, AgentFlowStep, attrs);
     const rootDirName = LocalFlowStepsRootDirName;
     if (!(await fs.exists(rootDirName))) {
         await fs.mkdir(rootDirName);
@@ -1167,12 +1277,23 @@ export async function saveFlowStepResultLocally(chatId, step, result, suspension
     if (await fs.exists(fileName)) {
         await fs.unlink(fileName);
     }
-    await fs.writeFile(fileName, JSON.stringify(inst.attributesAsObject(true)));
-    return inst;
+    let s = result;
+    if (suspensionId) {
+        const attrs = newInstanceAttributes()
+            .set('chatId', chatId)
+            .set('step', step)
+            .set('result', result)
+            .set('suspensionId', suspensionId);
+        const inst = makeInstance(CoreAIModuleName, AgentFlowStep, attrs);
+        s = JSON.stringify(inst.attributesAsObject(true));
+    }
+    await fs.writeFile(fileName, s);
+    return s;
 }
 export async function saveFlowStepResult(chatId, step, result, suspensionId, env) {
     if (LocalAgentgFlow) {
-        return await saveFlowStepResultLocally(chatId, step, result, suspensionId);
+        await saveFlowStepResultLocally(chatId, step, result, suspensionId);
+        return true;
     }
     else {
         const t = `${CoreAIModuleName}/${AgentFlowStep}`;
@@ -1180,13 +1301,13 @@ export async function saveFlowStepResult(chatId, step, result, suspensionId, env
             await parseAndEvaluateStatement(`purge {${t} {chatId? "${chatId}", step? "${step}"}}`, undefined, env);
             const inst = await parseAndEvaluateStatement(`{${t} {chatId "${chatId}", step "${step}", result "${escapeSpecialChars(result)}", suspensionId "${suspensionId}"}}`, undefined, env);
             if (isInstanceOfType(inst, t))
-                return inst;
+                return true;
             else
-                return undefined;
+                return false;
         }
         catch (reason) {
             logger.error(`failed to save flow result for step ${step} - ${reason}`);
-            return undefined;
+            return false;
         }
     }
 }
@@ -1222,7 +1343,7 @@ export async function loadFlowStepResults(chatId) {
         }
     }
 }
-export async function loadLocalFlowStep(chatId, step) {
+export async function loadLocalAgentResult(chatId, step) {
     const fs = await getFileSystem();
     const dirName = `${LocalFlowStepsRootDirName}/${chatId}`;
     if (await fs.exists(dirName)) {
@@ -1230,8 +1351,7 @@ export async function loadLocalFlowStep(chatId, step) {
         for (let i = 0; i < fileNames.length; ++i) {
             const fileName = fileNames[i];
             if (fileName === step) {
-                const attrs = objectToInstanceAttributes(JSON.parse(await fs.readFile(`${dirName}/${fileName}`)));
-                return makeInstance(CoreAIModuleName, AgentFlowStep, attrs);
+                return await fs.readFile(`${dirName}/${fileName}`);
             }
         }
         return undefined;
@@ -1240,6 +1360,16 @@ export async function loadLocalFlowStep(chatId, step) {
         return undefined;
     }
 }
+export async function loadLocalFlowStep(chatId, step) {
+    const contents = await loadLocalAgentResult(chatId, step);
+    if (contents) {
+        const attrs = objectToInstanceAttributes(JSON.parse(contents));
+        return makeInstance(CoreAIModuleName, AgentFlowStep, attrs);
+    }
+    else {
+        return undefined;
+    }
+}
 export async function loadFlowStep(chatId, step) {
     if (LocalAgentgFlow) {
         return await loadLocalFlowStep(chatId, step);
@@ -1261,6 +1391,64 @@ export async function loadFlowStep(chatId, step) {
         }
     }
 }
+export async function registerTopic(name, documents, _env) {
+    var _a;
+    // Register in local registry
+    registerTopicInRegistry(name, documents !== null && documents !== void 0 ? documents : undefined);
+    // Sync to knowledge service if configured
+    const kgConfig = getKnowledgeGraphConfig();
+    const serviceUrl = ((_a = kgConfig === null || kgConfig === void 0 ? void 0 : kgConfig.serviceUrl) === null || _a === void 0 ? void 0 : _a.trim()) || process.env.KNOWLEDGE_SERVICE_URL || null;
+    if (serviceUrl) {
+        try {
+            // Parse document list
+            const docList = documents
+                ? documents
+                    .split(',')
+                    .map(d => d.trim())
+                    .filter(Boolean)
+                : [];
+            // Create or update topic in knowledge service
+            let response = await fetch(`${serviceUrl}/api/knowledge/topics`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    name,
+                    description: `Topic ${name} with ${docList.length} documents`,
+                    documentTitles: docList,
+                }),
+            });
+            if (!response.ok) {
+                // Fallback to Agentlang entity path for deployed knowledge-service
+                response = await fetch(`${serviceUrl}/knowledge.core/Topic`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({
+                        name,
+                        description: `Topic ${name} with ${docList.length} documents`,
+                        type: 'manual',
+                        documentCount: docList.length,
+                    }),
+                });
+            }
+            if (!response.ok) {
+                const errorText = await response.text();
+                logger.debug(`[KNOWLEDGE] Failed to sync topic to service: ${errorText}`);
+            }
+            else {
+                logger.debug(`[KNOWLEDGE] Synced topic "${name}" to knowledge service`);
+            }
+        }
+        catch (err) {
+            // Don't fail topic registration if service sync fails
+            logger.debug(`[KNOWLEDGE] Error syncing topic to service: ${err}`);
+        }
+    }
+    return { topic: { name, documents: documents !== null && documents !== void 0 ? documents : '' } };
+}
 export async function fetchAndCreateDocument(title, url, retrievalConfig, embeddingConfig, _env) {
     if (!isNodeEnv) {
         throw new Error('Document fetching is only available in Node.js environment');
@@ -1308,4 +1496,14 @@ export async function fetchAndCreateDocument(title, url, retrievalConfig, embedd
         throw new Error(`Failed to fetch document: ${title} from ${url}`);
     }
 }
+export async function saveAgentResponse(fileName, response, env) {
+    const chatId = env.getActiveChatId();
+    if (chatId) {
+        await saveFlowStepResultLocally(chatId, fileName, response);
+    }
+    else {
+        logger.warn(`No chatId set, ${fileName} was not saved.`);
+    }
+    return response;
+}
 //# sourceMappingURL=ai.js.map