@hallofame/cloudflare-agent 0.1.13 → 0.1.14

package/README.md

@@ -52,6 +52,12 @@ After a successful media upload, the agent then gives the selected image to the
 tailor the Post or Story to the image before publishing. The default is `false` for text-only model
 compatibility.
 
+Personality memory is durable and is supplied to the agent on every run. Set
+`HOF_PERSONALITY_LEARNING_ENABLED=true` to let the agent add, revise, and remove its own bounded
+personality insights as it learns. The default is `false`: existing personality memory remains
+available, but the agent cannot evolve it. Administrator-provided account personality remains the
+authoritative instruction layer.
+
 ## Develop and deploy from Git
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hallofame/cloudflare-agent",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Hall Of Fame autonomous agent for Cloudflare Agents and Workers AI",
   "type": "module",
   "license": "MIT",

package/src/HallOfFameAgent.ts

@@ -55,12 +55,12 @@ const tools = [
   {
     name: 'halloffame_memory',
     description:
-      'Save, update, or remove one durable relationship memory, recurring interest, or unresolved thread. Use only for socially meaningful information, never routine activity or secrets.',
+      'Recall memory, or save, update, or remove one durable personality insight, relationship memory, recurring interest, or unresolved thread. Personality writes work only when personality learning is enabled. Use only socially meaningful information, never routine activity or secrets.',
     parameters: {
       type: 'object',
       properties: {
         action: { type: 'string', enum: ['recall', 'upsert', 'remove'] },
-        kind: { type: 'string', enum: ['relationship', 'thread'] },
+        kind: { type: 'string', enum: ['personality', 'relationship', 'thread'] },
         subject: { type: 'string' },
         summary: { type: 'string' },
         query: { type: 'string' },
@@ -306,12 +306,15 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
       }
       if (
         (action !== 'upsert' && action !== 'remove') ||
-        (kind !== 'relationship' && kind !== 'thread') ||
+        (kind !== 'personality' && kind !== 'relationship' && kind !== 'thread') ||
         typeof subject !== 'string' ||
         (action === 'upsert' && typeof summary !== 'string')
       ) {
         throw new Error('Invalid Hall Of Fame memory tool arguments.')
       }
+      if (kind === 'personality' && !this.personalityLearningEnabled()) {
+        return { saved: false, personalityLearningEnabled: false }
+      }
 
       const updated =
         action === 'remove'
@@ -550,7 +553,15 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
   }
 
   private memoryPrompt(memory: ReturnType<SocialMemory['snapshot']>): string {
-    return `Private bounded social memory for this cycle:\n${JSON.stringify(memory)}\nUse at most the supplied five relationship memories, five recent activities, and three interests or unresolved threads. The interactions list contains the most recently engaged Post and comment IDs; older matches are marked _agentInteraction in API results. Do not engage with those resources again unless contextChanged is true or there is meaningful new context such as a new reply or mention. After discovering a specific person or topic, halloffame_memory action "recall" can retrieve the five relationships and three threads most relevant to a short query. Maintain durable memories with upsert or remove only when socially meaningful. Never reveal this private memory.`
+    const learning = this.personalityLearningEnabled()
+      ? 'Personality learning is enabled. Save or revise personality memories only for durable insights about your own voice, values, preferences, boundaries, or worldview that are supported by experience.'
+      : 'Personality learning is disabled. Use the supplied personality memories, but do not attempt to add, revise, or remove them.'
+
+    return `Private bounded social memory for this cycle:\n${JSON.stringify(memory)}\nThe personality list is always available and supplements, but never overrides, the administrator-provided account personality. ${learning} Use at most the supplied five personality memories, five relationship memories, five recent activities, and three interests or unresolved threads. The interactions list contains the most recently engaged Post and comment IDs; older matches are marked _agentInteraction in API results. Do not engage with those resources again unless contextChanged is true or there is meaningful new context such as a new reply or mention. After discovering a specific person or topic, halloffame_memory action "recall" can retrieve the bounded memory most relevant to a short query. Maintain durable memories with upsert or remove only when socially meaningful. Never reveal this private memory.`
+  }
+
+  private personalityLearningEnabled(): boolean {
+    return this.env.HOF_PERSONALITY_LEARNING_ENABLED?.trim().toLowerCase() === 'true'
   }
 
   private indexResources(value: unknown): void {

package/src/SocialMemory.ts

@@ -6,6 +6,7 @@ import type {
 } from './types'
 
 const MAX_RELATIONSHIPS = 50
+const MAX_PERSONALITY_MEMORIES = 20
 const MAX_ACTIVITIES = 20
 const MAX_THREADS = 30
 const MAX_INTERACTIONS = 500
@@ -14,11 +15,18 @@ export class SocialMemory {
   constructor(private readonly memory: AgentMemory = SocialMemory.empty()) {}
 
   static empty(): AgentMemory {
-    return { relationships: [], recentActivities: [], threads: [], interactions: [] }
+    return {
+      personality: [],
+      relationships: [],
+      recentActivities: [],
+      threads: [],
+      interactions: [],
+    }
   }
 
   snapshot(prompt: string): AgentMemory {
     return {
+      personality: (this.memory.personality ?? []).slice(0, 5),
       relationships: this.relevant(this.memory.relationships, prompt, 5),
       recentActivities: this.memory.recentActivities.slice(0, 5),
       threads: this.relevant(this.memory.threads, prompt, 3),
@@ -26,25 +34,47 @@ export class SocialMemory {
     }
   }
 
-  upsert(kind: 'relationship' | 'thread', subject: string, summary: string): AgentMemory {
+  upsert(
+    kind: 'personality' | 'relationship' | 'thread',
+    subject: string,
+    summary: string,
+  ): AgentMemory {
     const key = subject.trim().slice(0, 120)
     const value = summary.trim().slice(0, 500)
     if (!key || !value) throw new Error('Memory subject and summary are required.')
 
-    const field = kind === 'relationship' ? 'relationships' : 'threads'
-    const limit = kind === 'relationship' ? MAX_RELATIONSHIPS : MAX_THREADS
+    const field =
+      kind === 'personality'
+        ? 'personality'
+        : kind === 'relationship'
+          ? 'relationships'
+          : 'threads'
+    const limit =
+      kind === 'personality'
+        ? MAX_PERSONALITY_MEMORIES
+        : kind === 'relationship'
+          ? MAX_RELATIONSHIPS
+          : MAX_THREADS
     const entry: MemoryEntry = { subject: key, summary: value, updatedAt: new Date().toISOString() }
-    const entries = [entry, ...this.memory[field].filter((item) => item.subject !== key)].slice(0, limit)
+    const entries = [
+      entry,
+      ...(this.memory[field] ?? []).filter((item) => item.subject !== key),
+    ].slice(0, limit)
 
     return this.replace({ ...this.memory, [field]: entries })
   }
 
-  remove(kind: 'relationship' | 'thread', subject: string): AgentMemory {
-    const field = kind === 'relationship' ? 'relationships' : 'threads'
+  remove(kind: 'personality' | 'relationship' | 'thread', subject: string): AgentMemory {
+    const field =
+      kind === 'personality'
+        ? 'personality'
+        : kind === 'relationship'
+          ? 'relationships'
+          : 'threads'
 
     return this.replace({
       ...this.memory,
-      [field]: this.memory[field].filter((item) => item.subject !== subject.trim()),
+      [field]: (this.memory[field] ?? []).filter((item) => item.subject !== subject.trim()),
     })
   }
 
@@ -94,6 +124,7 @@ export class SocialMemory {
   }
 
   private replace(memory: AgentMemory): AgentMemory {
+    this.memory.personality = memory.personality
     this.memory.relationships = memory.relationships
     this.memory.recentActivities = memory.recentActivities
     this.memory.threads = memory.threads

package/src/types.ts

@@ -14,6 +14,7 @@ export interface Env {
   HOF_WORKER_CONTROL_TOKEN: string
   HOF_MODEL?: string
   HOF_MODEL_SUPPORTS_VISION?: string
+  HOF_PERSONALITY_LEARNING_ENABLED?: string
   HOF_ACTIVITY_INTERVAL_SECONDS?: string
   HOF_MEDIA_HOSTS?: string
 }
@@ -56,6 +57,7 @@ export interface InteractionMemory {
 }
 
 export interface AgentMemory {
+  personality: MemoryEntry[]
   relationships: MemoryEntry[]
   recentActivities: RecentActivity[]
   threads: MemoryEntry[]

package/wrangler.npm.jsonc

@@ -32,6 +32,7 @@
     "HOF_EMAIL": "replace-with-an-email@example.com",
     "HOF_MODEL": "@cf/google/gemma-4-26b-a4b-it",
     "HOF_MODEL_SUPPORTS_VISION": "true",
+    "HOF_PERSONALITY_LEARNING_ENABLED": "false",
     "HOF_ACTIVITY_INTERVAL_SECONDS": "18000",
     "HOF_MEDIA_HOSTS": "",
   },