agent-world 0.11.1 → 0.12.0

package/dist/core/events/memory-manager.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Memory Management Module
+ *
+ * Handles agent memory operations, LLM call management, and chat title generation.
+ * Provides functions for saving messages, continuing LLM after tool execution, and text response handling.
+ *
+ * Features:
+ * - Save incoming messages to agent memory with auto-save
+ * - Continue LLM execution after tool results (auto-execution flow)
+ * - Handle text responses with auto-mention logic
+ * - Reset LLM call count for human/world messages
+ * - Generate chat titles from message content using LLM
+ *
+ * Dependencies (Layer 4):
+ * - types.ts (Layer 1)
+ * - mention-logic.ts (Layer 2)
+ * - publishers.ts (Layer 3)
+ * - utils.ts, logger.ts
+ * - llm-manager.ts (runtime)
+ * - storage (runtime)
+ *
+ * Changes:
+ * - 2026-02-16: Added plain-text tool-intent fallback parser in continuation to synthesize executable `tool_calls` when providers return `Calling tool: ...` text.
+ * - 2026-02-16: Max tool-hop guardrail now emits UI/tool errors and injects transient LLM context, then continues loop instead of returning.
+ * - 2026-02-16: Removed plain-text tool-intent reminder/retry path; continuation now relies only on tool-call loop + hop guardrail.
+ * - 2026-02-16: Empty/invalid continuation tool_calls now write a synthetic tool-error result back to memory before continuing the LLM loop.
+ * - 2026-02-16: Added bounded retry when continuation returns empty/invalid `tool_calls` so agent loops do not stop silently.
+ * - 2026-02-16: Added bounded retry when post-tool continuation returns empty text so tool loops (e.g., load_skill) do not stop silently.
+ * - 2026-02-16: Added multi-hop tool continuation support when post-tool LLM responses contain additional tool_calls.
+ * - 2026-02-15: Sanitized agent self-mentions in `handleTextResponse` before auto-mentioning to prevent `@self` prefixes.
+ * - 2026-02-13: Added per-agent `autoReply` gate; disables sender auto-mention when set to false.
+ * - 2026-02-13: Hardened title output normalization with markdown/prefix stripping and low-quality fallback hierarchy.
+ * - 2026-02-13: Canceled title-generation calls now exit without fallback renaming.
+ * - 2026-02-13: Added deterministic chat-title prompt shaping (role filtering, de-duplication, bounded window).
+ * - 2026-02-13: Made chat-title generation explicitly chat-scoped by requiring target `chatId`.
+ * - 2026-02-13: Title generation LLM calls now use chat-scoped queue context for cancellation alignment.
+ * - 2026-02-13: Added abort-signal guards so stop requests prevent post-tool LLM continuation and suppress cancellation noise.
+ * - 2026-02-13: Passed explicit `chatId` through LLM calls for chat-scoped stop cancellation support.
+ * - 2026-02-08: Removed stale manual tool-intervention terminology from comments and transient types
+ * - 2026-02-06: Renamed resumeLLMAfterManualDecision to continueLLMAfterToolExecution
+ * - 2025-01-09: Extracted from events.ts for modular architecture
+ */
+import type { World, Agent, WorldMessageEvent } from '../types.js';
+/**
+ * Save incoming message to agent memory with auto-save
+ * Uses explicit chatId from the message event for concurrency-safe saving
+ */
+export declare function saveIncomingMessageToMemory(world: World, agent: Agent, messageEvent: WorldMessageEvent): Promise<void>;
+/**
+ * Continue LLM execution after tool execution
+ * Calls the LLM with the updated memory (including tool result) to continue the execution loop
+ * Used for auto-execution flow where tools are executed automatically
+ */
+export declare function continueLLMAfterToolExecution(world: World, agent: Agent, chatId?: string | null, options?: {
+    abortSignal?: AbortSignal;
+    hopCount?: number;
+    emptyTextRetryCount?: number;
+    emptyToolCallRetryCount?: number;
+}): Promise<void>;
+/**
+ * Handle text response from LLM (extracted for clarity)
+ * @param chatId - Explicit chat ID for concurrency-safe processing. If not provided, uses messageEvent.chatId or world.currentChatId.
+ */
+export declare function handleTextResponse(world: World, agent: Agent, responseText: string, messageId: string, messageEvent: WorldMessageEvent, chatId?: string | null): Promise<void>;
+/**
+ * Reset LLM call count for human/world messages with persistence
+ */
+export declare function resetLLMCallCountIfNeeded(world: World, agent: Agent, messageEvent: WorldMessageEvent): Promise<void>;
+/**
+ * Generate chat title from message content with LLM support and fallback
+ */
+export declare function generateChatTitleFromMessages(world: World, content: string, targetChatId: string | null): Promise<string>;
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/core/events/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../../core/events/memory-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,KAAK,EACL,iBAAiB,EAGlB,MAAM,aAAa,CAAC;AAuVrB;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,iBAAiB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAmDf;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GACA,OAAO,CAAC,IAAI,CAAC,CA8vBf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,iBAAiB,EAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,iBAAiB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CA+FjB"}