@elevasis/core 0.7.0 → 0.8.0

package/src/execution/engine/agent/reasoning/prompt-sections/knowledge-map.ts

@@ -1,93 +1,93 @@
-/**
- * Knowledge Map Section
- * Formats knowledge map nodes (loaded vs unloaded) with comprehensive navigation instructions
- */
-
-import { KnowledgeMap } from '../../knowledge-map/types'
-
-/**
- * Builds the knowledge map section of the system prompt
- * Includes conceptual overview, navigation instructions, workflow examples,
- * and separates loaded nodes (with full prompts) from unloaded nodes (available to load)
- *
- * @param knowledgeMap - Knowledge map instance with nodes
- * @returns Knowledge map prompt section, or empty string if no nodes
- */
-export function buildKnowledgeMapPrompt(knowledgeMap?: KnowledgeMap): string {
-  // No knowledge map or no nodes - skip section
-  if (!knowledgeMap || Object.keys(knowledgeMap.nodes).length === 0) {
-    return ''
-  }
-
-  let section = '## Knowledge Map\n\n'
-
-  // Conceptual overview
-  section += 'Knowledge maps provide on-demand access to specialized capabilities. '
-  section += 'Each node contains domain-specific instructions and tools.\n\n'
-
-  // Critical instruction - most common mistake
-  section += '**CRITICAL**: After navigating to a node, tools become available in the **NEXT iteration**. '
-  section += 'Do NOT attempt to use tools in the same iteration as navigation.\n\n'
-
-  // Separate loaded vs unloaded nodes
-  const loadedNodes: (typeof knowledgeMap.nodes)[string][] = []
-  const unloadedNodes: (typeof knowledgeMap.nodes)[string][] = []
-
-  Object.values(knowledgeMap.nodes).forEach((node) => {
-    if (node.loaded && node.prompt) {
-      loadedNodes.push(node)
-    } else {
-      unloadedNodes.push(node)
-    }
-  })
-
-  // Show loaded nodes with full prompts
-  if (loadedNodes.length > 0) {
-    section += '### Loaded Knowledge\n\n'
-    section += 'These nodes are active - their tools are available now:\n\n'
-    loadedNodes.forEach((node) => {
-      section += `**${node.id}**\n${node.prompt}\n\n`
-    })
-  }
-
-  // Show unloaded nodes (available to load)
-  if (unloadedNodes.length > 0) {
-    section += '### Available to Load\n\n'
-    unloadedNodes.forEach((node) => {
-      section += `- **${node.id}**: ${node.description}\n`
-    })
-
-    // Navigation format
-    section += '\n### How to Navigate\n\n'
-    section += '```json\n'
-    section += '{ "type": "navigate-knowledge", "id": "unique-id", "nodeId": "node-id" }\n'
-    section += '```\n\n'
-
-    // Workflow example - shows the 2-iteration pattern
-    section += '### Typical Workflow\n\n'
-    section += '**Iteration 1 - Navigate to load knowledge:**\n'
-    section += '```json\n'
-    section += '{\n'
-    section += '  "reasoning": "I need [domain] capabilities to accomplish this task.",\n'
-    section += '  "nextActions": [\n'
-    section += '    { "type": "navigate-knowledge", "id": "nav-1", "nodeId": "[node-id]" }\n'
-    section += '  ]\n'
-    section += '}\n'
-    section += '```\n\n'
-    section += '**Iteration 2 - Use newly available tools:**\n'
-    section += '```json\n'
-    section += '{\n'
-    section += '  "reasoning": "Now I have [domain] tools. Using [tool_name] to [action].",\n'
-    section += '  "nextActions": [\n'
-    section += '    { "type": "tool-call", "id": "t1", "name": "[tool_name]", "input": {...} }\n'
-    section += '  ]\n'
-    section += '}\n'
-    section += '```\n\n'
-
-    // Cross-turn persistence note
-    section += '**Note:** Loaded knowledge persists across conversation turns. '
-    section += 'Previously loaded nodes remain available without re-navigation.\n'
-  }
-
-  return section + '\n'
-}
+/**
+ * Knowledge Map Section
+ * Formats knowledge map nodes (loaded vs unloaded) with comprehensive navigation instructions
+ */
+
+import { KnowledgeMap } from '../../knowledge-map/types'
+
+/**
+ * Builds the knowledge map section of the system prompt
+ * Includes conceptual overview, navigation instructions, workflow examples,
+ * and separates loaded nodes (with full prompts) from unloaded nodes (available to load)
+ *
+ * @param knowledgeMap - Knowledge map instance with nodes
+ * @returns Knowledge map prompt section, or empty string if no nodes
+ */
+export function buildKnowledgeMapPrompt(knowledgeMap?: KnowledgeMap): string {
+  // No knowledge map or no nodes - skip section
+  if (!knowledgeMap || Object.keys(knowledgeMap.nodes).length === 0) {
+    return ''
+  }
+
+  let section = '## Knowledge Map\n\n'
+
+  // Conceptual overview
+  section += 'Knowledge maps provide on-demand access to specialized capabilities. '
+  section += 'Each node contains domain-specific instructions and tools.\n\n'
+
+  // Critical instruction - most common mistake
+  section += '**CRITICAL**: After navigating to a node, tools become available in the **NEXT iteration**. '
+  section += 'Do NOT attempt to use tools in the same iteration as navigation.\n\n'
+
+  // Separate loaded vs unloaded nodes
+  const loadedNodes: (typeof knowledgeMap.nodes)[string][] = []
+  const unloadedNodes: (typeof knowledgeMap.nodes)[string][] = []
+
+  Object.values(knowledgeMap.nodes).forEach((node) => {
+    if (node.loaded && node.prompt) {
+      loadedNodes.push(node)
+    } else {
+      unloadedNodes.push(node)
+    }
+  })
+
+  // Show loaded nodes with full prompts
+  if (loadedNodes.length > 0) {
+    section += '### Loaded Knowledge\n\n'
+    section += 'These nodes are active - their tools are available now:\n\n'
+    loadedNodes.forEach((node) => {
+      section += `**${node.id}**\n${node.prompt}\n\n`
+    })
+  }
+
+  // Show unloaded nodes (available to load)
+  if (unloadedNodes.length > 0) {
+    section += '### Available to Load\n\n'
+    unloadedNodes.forEach((node) => {
+      section += `- **${node.id}**: ${node.description}\n`
+    })
+
+    // Navigation format
+    section += '\n### How to Navigate\n\n'
+    section += '```json\n'
+    section += '{ "type": "navigate-knowledge", "id": "unique-id", "nodeId": "node-id" }\n'
+    section += '```\n\n'
+
+    // Workflow example - shows the 2-iteration pattern
+    section += '### Typical Workflow\n\n'
+    section += '**Iteration 1 - Navigate to load knowledge:**\n'
+    section += '```json\n'
+    section += '{\n'
+    section += '  "reasoning": "I need [domain] capabilities to accomplish this task.",\n'
+    section += '  "nextActions": [\n'
+    section += '    { "type": "navigate-knowledge", "id": "nav-1", "nodeId": "[node-id]" }\n'
+    section += '  ]\n'
+    section += '}\n'
+    section += '```\n\n'
+    section += '**Iteration 2 - Use newly available tools:**\n'
+    section += '```json\n'
+    section += '{\n'
+    section += '  "reasoning": "Now I have [domain] tools. Using [tool_name] to [action].",\n'
+    section += '  "nextActions": [\n'
+    section += '    { "type": "tool-call", "id": "t1", "name": "[tool_name]", "input": {...} }\n'
+    section += '  ]\n'
+    section += '}\n'
+    section += '```\n\n'
+
+    // Cross-turn persistence note
+    section += '**Note:** Loaded knowledge persists across conversation turns. '
+    section += 'Previously loaded nodes remain available without re-navigation.\n'
+  }
+
+  return section + '\n'
+}

package/src/execution/engine/agent/reasoning/prompt-sections/memory.ts

@@ -1,65 +1,65 @@
-/**
- * Memory Management Section
- * Provides guidance on session memory operations (SET/DELETE) with dynamic status
- */
-
-/**
- * Memory status information for prompt generation
- */
-export interface MemoryStatus {
-  sessionMemoryKeys: number
-  sessionMemoryLimit: number
-  historyPercent: number
-}
-
-/**
- * Builds the memory management section of the system prompt
- * Includes SET/DELETE operations, memory status, and persistence guidance
- *
- * @param memoryStatus - Current memory usage statistics
- * @param preferences - Optional agent-specific memory preferences (string)
- * @returns Memory management prompt section
- */
-export function buildMemoryPrompt(memoryStatus: MemoryStatus, preferences?: string): string {
-  return `## Memory Management
-
-You have control over session memory. Use memoryOps to manage critical information:
-
-**SET critical information:**
-\`\`\`json
-{
-  "memoryOps": {
-    "set": {
-      "customer_account": "Account #12345, Premium tier, expires 2026-03-15",
-      "original_request": "Fix broken widget"
-    }
-  }
-}
-\`\`\`
-
-**DELETE outdated information:**
-\`\`\`json
-{
-  "memoryOps": {
-    "delete": ["old_address", "cancelled_order"]
-  }
-}
-\`\`\`
-
-**When to persist:**
-- Memory at ${memoryStatus.historyPercent}%: ${memoryStatus.historyPercent >= 80 ? 'Proactively persist important context NOW (auto-compaction at 100%)' : 'Normal operation'}
-- Session keys at ${memoryStatus.sessionMemoryKeys}/${memoryStatus.sessionMemoryLimit}: Delete outdated keys before adding new ones
-- Always: Persist critical data that should survive memory compaction
-
-**IMPORTANT - System-Managed Memory:**
-Do NOT update these keys via memoryOps (managed automatically by tools/actions):
-- notion-pages-cache (managed by Notion tools)
-- knowledge-map-state (managed by navigate-knowledge)
-
-Attempting to update system-managed keys will be rejected. Use tools to update their caches.
-${preferences ? `\n**Agent-Specific Guidance:**\n${preferences}\n` : ''}
-Framework auto-compacts history at 100% token budget.
-You control WHAT to remember. Framework controls HOW compaction works.
-
-`
-}
+/**
+ * Memory Management Section
+ * Provides guidance on session memory operations (SET/DELETE) with dynamic status
+ */
+
+/**
+ * Memory status information for prompt generation
+ */
+export interface MemoryStatus {
+  sessionMemoryKeys: number
+  sessionMemoryLimit: number
+  historyPercent: number
+}
+
+/**
+ * Builds the memory management section of the system prompt
+ * Includes SET/DELETE operations, memory status, and persistence guidance
+ *
+ * @param memoryStatus - Current memory usage statistics
+ * @param preferences - Optional agent-specific memory preferences (string)
+ * @returns Memory management prompt section
+ */
+export function buildMemoryPrompt(memoryStatus: MemoryStatus, preferences?: string): string {
+  return `## Memory Management
+
+You have control over session memory. Use memoryOps to manage critical information:
+
+**SET critical information:**
+\`\`\`json
+{
+  "memoryOps": {
+    "set": {
+      "customer_account": "Account #12345, Premium tier, expires 2026-03-15",
+      "original_request": "Fix broken widget"
+    }
+  }
+}
+\`\`\`
+
+**DELETE outdated information:**
+\`\`\`json
+{
+  "memoryOps": {
+    "delete": ["old_address", "cancelled_order"]
+  }
+}
+\`\`\`
+
+**When to persist:**
+- Memory at ${memoryStatus.historyPercent}%: ${memoryStatus.historyPercent >= 80 ? 'Proactively persist important context NOW (auto-compaction at 100%)' : 'Normal operation'}
+- Session keys at ${memoryStatus.sessionMemoryKeys}/${memoryStatus.sessionMemoryLimit}: Delete outdated keys before adding new ones
+- Always: Persist critical data that should survive memory compaction
+
+**IMPORTANT - System-Managed Memory:**
+Do NOT update these keys via memoryOps (managed automatically by tools/actions):
+- notion-pages-cache (managed by Notion tools)
+- knowledge-map-state (managed by navigate-knowledge)
+
+Attempting to update system-managed keys will be rejected. Use tools to update their caches.
+${preferences ? `\n**Agent-Specific Guidance:**\n${preferences}\n` : ''}
+Framework auto-compacts history at 100% token budget.
+You control WHAT to remember. Framework controls HOW compaction works.
+
+`
+}

package/src/execution/engine/agent/reasoning/prompt-sections/tools.ts

@@ -1,44 +1,44 @@
-/**
- * Tools Section
- * Formats available tools with input schemas and usage instructions
- */
-
-import type { ToolDefinition } from '../../../tools/types'
-
-/**
- * Builds the tools section of the system prompt
- * Lists available tools with descriptions, input schemas, and usage examples
- *
- * @param tools - Array of tool definitions with schemas
- * @returns Tools prompt section, or empty string if no tools
- */
-export function buildToolsPrompt(tools: ToolDefinition[]): string {
-  if (tools.length === 0) {
-    return ''
-  }
-
-  let section = '## Available Tools\n\n'
-  section +=
-    'You have access to the following tools. To use a tool, include a tool-call action in your nextActions array:\n\n'
-
-  // List each tool with description and schema
-  tools.forEach((tool) => {
-    section += `### ${tool.name}\n`
-    section += `${tool.description}\n`
-    section += `Input schema: ${JSON.stringify(tool.inputSchema, null, 2)}\n\n`
-  })
-
-  // Add usage instructions
-  section += 'To call a tool, return a tool-call action:\n'
-  section +=
-    '{\n  "type": "tool-call",\n  "id": "unique-id",\n  "name": "tool-name",\n  "input": { /* tool input matching schema */ }\n}\n\n'
-
-  section += '**IMPORTANT RULES:**\n'
-  section += '1. "complete" CANNOT mix with tool-call or navigate-knowledge actions in the same response\n'
-  section += '2. "complete" CAN mix with message — always pair your final message with complete in the same iteration\n'
-  section += '3. To use tools, return ONLY tool-call actions, then wait for results in the next iteration\n'
-  section += '4. After receiving tool results, you can either call more tools OR complete with final answer\n'
-  section += '5. navigate-knowledge actions load new capabilities - tools become available in the next iteration\n'
-
-  return section + '\n'
-}
+/**
+ * Tools Section
+ * Formats available tools with input schemas and usage instructions
+ */
+
+import type { ToolDefinition } from '../../../tools/types'
+
+/**
+ * Builds the tools section of the system prompt
+ * Lists available tools with descriptions, input schemas, and usage examples
+ *
+ * @param tools - Array of tool definitions with schemas
+ * @returns Tools prompt section, or empty string if no tools
+ */
+export function buildToolsPrompt(tools: ToolDefinition[]): string {
+  if (tools.length === 0) {
+    return ''
+  }
+
+  let section = '## Available Tools\n\n'
+  section +=
+    'You have access to the following tools. To use a tool, include a tool-call action in your nextActions array:\n\n'
+
+  // List each tool with description and schema
+  tools.forEach((tool) => {
+    section += `### ${tool.name}\n`
+    section += `${tool.description}\n`
+    section += `Input schema: ${JSON.stringify(tool.inputSchema, null, 2)}\n\n`
+  })
+
+  // Add usage instructions
+  section += 'To call a tool, return a tool-call action:\n'
+  section +=
+    '{\n  "type": "tool-call",\n  "id": "unique-id",\n  "name": "tool-name",\n  "input": { /* tool input matching schema */ }\n}\n\n'
+
+  section += '**IMPORTANT RULES:**\n'
+  section += '1. "complete" CANNOT mix with tool-call or navigate-knowledge actions in the same response\n'
+  section += '2. "complete" CAN mix with message — always pair your final message with complete in the same iteration\n'
+  section += '3. To use tools, return ONLY tool-call actions, then wait for results in the next iteration\n'
+  section += '4. After receiving tool results, you can either call more tools OR complete with final answer\n'
+  section += '5. navigate-knowledge actions load new capabilities - tools become available in the next iteration\n'
+
+  return section + '\n'
+}