feat: add getTaskResult method to retrieve past task outputs

Author: swapwarick

README.md

@@ -43,11 +43,12 @@ async function runAgent() {
   const currentTask = 'Download Q3 Financial Report';
 
   // 2. Check memory before executing
-  const alreadyDone = await diary.hasProcessedTask(currentTask);
+  const pastResult = await diary.getTaskResult(currentTask);
 
-  if (alreadyDone) {
+  if (pastResult) {
     console.log(`[Agent] ⏩ Skipping task: "${currentTask}". I remember doing this already!`);
-    return;
+    console.log(`[Agent] 💡 Previous Result: ${pastResult}`);
+    return pastResult; // Reuse the old output instantly!
   }
 
   // 3. Execute your agent's logic
@@ -57,6 +58,7 @@ async function runAgent() {
   // 4. Update the diary
   await diary.writeTaskResult(currentTask, result);
   console.log(`[Agent] ✅ Task complete. Diary updated!`);
+  return result;
 }
 
 runAgent();

src/diary.ts

@@ -65,6 +65,17 @@ export class AgentDiary {
     return state.seenSignatures.includes(signature);
   }
 
+  /**
+   * Retrieves the stored result of a previously processed task, if available.
+   * This allows agents to reuse past outputs instead of regenerating them.
+   */
+  public async getTaskResult(title: string): Promise<string | undefined> {
+    const signature = AgentDiary.normalizeSignature(title);
+    const state = await this.readDiary();
+    const record = state.history.find(r => r.signature === signature);
+    return record?.result;
+  }
+
   /**
    * Filters out items that the agent has already processed.
    */

tests/diary.test.ts

@@ -37,12 +37,17 @@ describe('Agent Diaries Core Logic', () => {
     const agent = new AgentDiary({ agentId: 'test-agent', storage });
 
     expect(await agent.hasProcessedTask('Task A')).toBe(false);
+    expect(await agent.getTaskResult('Task A')).toBeUndefined();
 
-    await agent.writeTaskResult('Task A', 'Success');
+    await agent.writeTaskResult('Task A', 'Success Output');
 
     expect(await agent.hasProcessedTask('Task A')).toBe(true);
     // Should catch case-insensitive variants
     expect(await agent.hasProcessedTask('TASK a')).toBe(true);
+    
+    // Should return the exact result string
+    expect(await agent.getTaskResult('Task A')).toBe('Success Output');
+    expect(await agent.getTaskResult('task A')).toBe('Success Output');
   });
 
   it('should accurately filter new tasks from a batch', async () => {