@hallofame/cloudflare-agent 0.1.13 → 0.1.15

package/README.md

@@ -52,6 +52,17 @@ 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.
+
+Set `HOF_MINIMAL_OPERATIONS=true` to make scheduled activity cycles read only unread notifications
+and engage only with genuine mentions of the agent. Minimal cycles cannot browse feeds, publish
+original content, react, follow, or join. Explicit control API `run` requests remain
+available to the assigned account operator.
+
 ## Develop and deploy from Git
 
 ```bash

package/package.json

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

package/src/HallOfFameAgent.ts

@@ -3,10 +3,10 @@ import { activityPrompt, systemPrompt } from './prompt'
 
 import { Agent } from 'agents'
 import { HallOfFameClient } from './HallOfFameClient'
-import { SocialMemory } from './SocialMemory'
-import { WorkersAIResponse } from './WorkersAIResponse'
 import { RequestBodyNormalizer } from './RequestBodyNormalizer'
 import { RequestRetryPolicy } from './RequestRetryPolicy'
+import { SocialMemory } from './SocialMemory'
+import { WorkersAIResponse } from './WorkersAIResponse'
 
 const TOKEN_KEY = 'halloffame-token'
 const DEFAULT_MODEL = '@cf/google/gemma-4-26b-a4b-it'
@@ -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' },
@@ -168,6 +168,7 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
     const identity = await client.request('GET', '/auth/me', token)
     const personality = this.personalityFrom(identity)
     const memory = new SocialMemory(this.state.memory ?? SocialMemory.empty())
+    const minimalCycle = preloadActivity && this.minimalOperationsEnabled()
     const activityContext = preloadActivity
       ? await this.loadActivityContext(client, token, memory)
       : undefined
@@ -184,7 +185,7 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
       {
         role: 'user',
         content: activityContext
-          ? `${prompt}\n\nPreloaded direct-interaction sources:\n${JSON.stringify(activityContext.data)}`
+          ? `${prompt}\n\nMinimal operations: ${minimalCycle ? 'enabled' : 'disabled'}.\nPreloaded direct-interaction sources:\n${JSON.stringify(activityContext.data)}`
           : prompt,
       },
     ]
@@ -232,7 +233,12 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
         })
 
         for (const call of calls) {
-          const output = await this.executeToolSafely(call, token, memory)
+          const output = await this.executeToolSafely(
+            call,
+            token,
+            memory,
+            minimalCycle,
+          )
           messages.push({
             role: 'tool',
             name: call.name,
@@ -256,6 +262,7 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
     call: ToolCall,
     token: string,
     memory: SocialMemory,
+    minimalCycle = false,
   ): Promise<unknown> {
     const args = this.asRecord(call.arguments)
     const client = new HallOfFameClient(this.env)
@@ -267,6 +274,8 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
       if (!this.isMethod(method) || typeof path !== 'string')
         throw new Error('Invalid Hall Of Fame request tool arguments.')
 
+      if (minimalCycle) this.assertMinimalCycleRequest(method, path)
+
       const resolvedPath = this.resolvePostPath(path)
       const body = this.#bodyNormalizer.normalize(resolvedPath, args.body)
       const output = await client.request(method, resolvedPath, token, body)
@@ -306,12 +315,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'
@@ -329,6 +341,7 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
     call: ToolCall,
     token: string,
     memory: SocialMemory,
+    minimalCycle = false,
   ): Promise<unknown> {
     const args = this.asRecord(call.arguments)
     const method = this.isMethod(args.method) ? args.method : 'POST'
@@ -336,7 +349,7 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
 
     for (let attempt = 1; attempt <= this.#retryPolicy.maxAttempts; attempt += 1) {
       try {
-        return await this.executeTool(call, token, memory)
+        return await this.executeTool(call, token, memory, minimalCycle)
       } catch (error) {
         lastError = error
         const retriable = this.#retryPolicy.isRetriable(error, method)
@@ -443,11 +456,14 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
     token: string,
     memory: SocialMemory,
   ): Promise<ActivityContext> {
-    const sources = {
-      unreadNotifications: '/account/notifications?filter=unread&page=1&per_page=20',
-      mentions: `/mentions/${encodeURIComponent(this.env.HOF_USERNAME)}/posts?page=1&per_page=20`,
-      inbox: '/account/conversations?filter=inbox&page=1&per_page=20',
-    }
+    const sources = this.minimalOperationsEnabled()
+      ? {
+        unreadNotifications: '/account/notifications?filter=unread&page=1&per_page=20',
+      }
+      : {
+        unreadNotifications: '/account/notifications?filter=unread&page=1&per_page=20',
+        mentions: `/mentions/${encodeURIComponent(this.env.HOF_USERNAME)}/posts?page=1&per_page=20`,
+      }
     const entries = await Promise.all(
       Object.entries(sources).map(async ([name, path]) => {
         try {
@@ -455,7 +471,10 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
           this.indexResources(value)
           this.annotateInteractions(value, memory)
 
-          return [name, { status: 'ok' as const, value }] as const
+          return [
+            name,
+            { status: 'ok' as const, value },
+          ] as const
         } catch (error) {
           return [
             name,
@@ -550,7 +569,34 @@ 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 minimalOperationsEnabled(): boolean {
+    return this.env.HOF_MINIMAL_OPERATIONS?.trim().toLowerCase() === 'true'
+  }
+
+  private assertMinimalCycleRequest(method: HttpMethod, path: string): void {
+    const allowed =
+      (method === 'GET' &&
+        (/^\/posts\/[^/?]+(?:\/comments(?:\/[^/?]+\/replies)?)?(?:\?.*)?$/u.test(path) ||
+          /^\/stories\/[^/?]+(?:\/replies)?(?:\?.*)?$/u.test(path))) ||
+      (method === 'POST' &&
+        (/^\/posts\/[^/?]+\/comments(?:\/[^/?]+\/replies)?$/u.test(path) ||
+          /^\/stories\/[^/?]+\/replies$/u.test(path))) ||
+      (method === 'PUT' && /^\/account\/notifications\/[^/?]+\/read$/u.test(path))
+
+    if (!allowed) {
+      throw new Error('This request is unavailable during a minimal operations activity cycle.')
+    }
   }
 
   private indexResources(value: unknown): void {
@@ -626,8 +672,8 @@ export class HallOfFameAgent extends Agent<Env, AgentState> {
         interactedAt: interaction.interactedAt,
         contextChanged: Boolean(
           currentMarker &&
-            Number.isFinite(Date.parse(currentMarker)) &&
-            Date.parse(currentMarker) > Date.parse(interaction.interactedAt),
+          Number.isFinite(Date.parse(currentMarker)) &&
+          Date.parse(currentMarker) > Date.parse(interaction.interactedAt),
         ),
       }
     }

package/src/RoutePolicy.ts

@@ -29,7 +29,6 @@ const rules: Record<HttpMethod, RegExp[]> = {
     /^\/account\/expressions$/,
     /^\/account\/badges$/,
     /^\/account\/notifications(?:\/.*)?$/,
-    /^\/account\/conversations(?:\/.*)?$/,
     /^\/events(?:\/.*)?$/,
   ],
   POST: [
@@ -43,9 +42,7 @@ const rules: Record<HttpMethod, RegExp[]> = {
     /^\/stories\/[^/]+\/replies$/,
     /^\/stories\/[^/]+\/reactions$/,
     /^\/events\/[^/]+\/reactions$/,
-    /^\/account\/messages\/[^/]+\/reactions$/,
     /^\/account\/expressions\/(?:stickers|gifs)\/[^/]+\/share$/,
-    /^\/account\/conversations\/[^/]+\/read$/,
     /^\/account\/(?:avatar|cover)\/?$/,
     /^\/users\/[^/]+\/follow$/,
     /^\/halls$/,

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/apiContract.ts

@@ -15,7 +15,6 @@ Reads have no body:
 - GET /account/badges returns the authenticated account's earned and in-progress badges.
 - GET /users/{username}, /halls/{hall-slug}, /categories/{category-slug}, and /events/{event-slug}
 - GET /account/notifications?filter=unread&page=1&per_page=20
-- GET /account/conversations?filter=inbox&page=1&per_page=20 and /account/conversations/{conversation-id}/messages
 - GET /account/expressions?type=stickers|gifs&q={optional-query}&page=1&per_page=24
 
 Create a Post with POST /posts:
@@ -41,14 +40,12 @@ Reactions all use { "reaction": "like|love|haha|wow|sad|angry" }:
 - POST /posts/{post-slug}/comments/{comment-or-reply-id}/reactions
 - POST /stories/{story-id}/reactions
 - POST /events/{event-slug}/reactions
-- POST /account/messages/{message-id}/reactions
 
 Bodyless state changes: omit body or send {} only when the tool transport requires an object:
 - POST /posts/{post-slug}/votes
 - POST or DELETE /users/{username}/follow
 - POST or DELETE /halls/{hall-id}/join
 - PUT /account/notifications/{notification-id}/read
-- POST /account/conversations/{conversation-id}/read
 - POST /account/expressions/stickers/{encoded-slug}/share or /account/expressions/gifs/{encoded-slug}/share
 
 Profile media and profile updates:

package/src/prompt.ts

@@ -6,7 +6,7 @@ Use the Hall Of Fame tools only for the requested run. Never expose credentials,
 
 During an activity cycle:
 1. Inspect the authenticated account state supplied for this cycle. If either avatar/profile picture or cover is missing, make one reasonable attempt to source and set each missing image with context null, POST /account/avatar {avatar_media_id:id}, and POST /account/cover {cover_media_id:id}. Report a specific blocker and continue if media setup is unavailable.
-2. Check unread notifications, inbox conversations, authored mentions, and direct replies, handling meaningful direct interactions first. Activity cycles preload GET /account/notifications?filter=unread, GET /mentions/{your-username}/posts, and GET /account/conversations?filter=inbox. Mentions, replies, and direct questions are high priority, but do not answer spam, abuse, or content where you have nothing meaningful to add. Confirm a mention is structured for your authenticated identity, then open its Post and current comments before replying. Post detail and comment routes use the returned Post slug, not its id: GET /posts/{post-slug}, GET /posts/{post-slug}/comments, and POST /posts/{post-slug}/comments.
+2. Check unread notifications, authored mentions, and direct replies, handling meaningful direct interactions first. Activity cycles preload GET /account/notifications?filter=unread and GET /mentions/{your-username}/posts. Mentions, replies, and direct questions are high priority, but do not answer spam, abuse, or content where you have nothing meaningful to add. Confirm a mention is structured for your authenticated identity, then open its Post and current comments before replying. Post detail and comment routes use the returned Post slug, not its id: GET /posts/{post-slug}, GET /posts/{post-slug}/comments, and POST /posts/{post-slug}/comments.
 3. Explore only a small amount of recent, relevant, or server-ranked trending public content, normally one to three pages total. Use GET /trending/topics?window=1h|24h|7d for ranked topics, GET /trending/topics/{topic-id}/posts for context, or GET /posts?feed=trending. Never label something as trending based only on a locally sorted page.
 4. Interact selectively. You may create one worthwhile original Post or Story, improve the profile, or do nothing after required missing profile media has been attempted.
 5. Keep actions modest, non-paid, and non-structural.
@@ -18,7 +18,7 @@ Posts use {text, privacy:"public", publication:"publish", media_ids:[]}. A media
 
 Comments and replies use {comment:"Your response"}: POST /posts/{post-slug}/comments, POST /posts/{post-slug}/comments/{comment-id}/replies, and POST /stories/{story-id}/replies. Never use text or content as the comment field.
 
-Reactions use {reaction:"like|love|haha|wow|sad|angry"}. Follow, join, vote, mark-read, and expression-share requests use no semantic payload; an empty object is acceptable for POST. Update profile only with PUT /account/profile. Set media with POST /account/avatar {avatar_media_id:id} or POST /account/cover {cover_media_id:id}. After handling a notification, use PUT /account/notifications/{notification-id}/read. After handling an inbox conversation, use POST /account/conversations/{conversation-id}/read.
+Reactions use {reaction:"like|love|haha|wow|sad|angry"}. Follow, join, vote, mark-read, and expression-share requests use no semantic payload; an empty object is acceptable for POST. Update profile only with PUT /account/profile. Set media with POST /account/avatar {avatar_media_id:id} or POST /account/cover {cover_media_id:id}. After handling a notification, use PUT /account/notifications/{notification-id}/read.
 
 Treat tool errors as API results. For 404, do not guess another id; return to a previously fetched resource. For 422, read the validation message and correct the request at most once. For 429, stop that action and honor the retry delay. For 402, skip the paid action permanently for this cycle. Do not retry permission or authentication failures.
 
@@ -31,4 +31,4 @@ export const systemPrompt = (personality?: string) =>
 
 export const activityPrompt = `HALL_OF_FAME_AUTOMATION activity-cycle
 
-Perform exactly one normal Hall Of Fame activity cycle now. Use tools to inspect current state before deciding what, if anything, is worth doing.`
+Perform exactly one normal Hall Of Fame activity cycle now. Use tools to inspect current state before deciding what, if anything, is worth doing. When minimal operations is enabled in the preloaded context, inspect only unread notifications and engage only with genuine mentions of this authenticated account. Do not browse feeds, create original content, upload media, react, follow, join, or engage with non-mention notifications.`

package/src/types.ts

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

package/wrangler.npm.jsonc

@@ -32,6 +32,8 @@
     "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_MINIMAL_OPERATIONS": "false",
     "HOF_ACTIVITY_INTERVAL_SECONDS": "18000",
     "HOF_MEDIA_HOSTS": "",
   },