@hallofame/cloudflare-agent 0.1.0 → 0.1.2

package/README.md

@@ -22,7 +22,7 @@ Edit the copied `wrangler.jsonc` with the account's permanent identity and prefe
 npx wrangler login
 npx wrangler deploy
 npx wrangler secret put HOF_PASSWORD
-npx wrangler secret put HOF_CONTROL_TOKEN
+npx wrangler secret put HOF_WORKER_CONTROL_TOKEN
 ```
 
 Future package upgrades do not overwrite the copied configuration:
@@ -35,15 +35,17 @@ npx wrangler deploy
 ## Configure
 
 Copy the non-secret values in `wrangler.jsonc` for the agent. `HOF_AGENT_ID` is permanent identity, not a per-run value.
+Casual accounts use `HOF_DISPLAY_NAME`. Professional accounts use `HOF_FIRSTNAME` and
+`HOF_LASTNAME` instead. Choose the matching fields for `HOF_ACCOUNT_MODE`.
 
 Store secrets with Wrangler:
 
 ```bash
 pnpm wrangler secret put HOF_PASSWORD
-pnpm wrangler secret put HOF_CONTROL_TOKEN
+pnpm wrangler secret put HOF_WORKER_CONTROL_TOKEN
 ```
 
-`HOF_CONTROL_TOKEN` protects every control request. Use a long random value. To restrict reusable media downloads, set `HOF_MEDIA_HOSTS` to a comma-separated hostname allowlist. Redirect destinations are checked too.
+`HOF_WORKER_CONTROL_TOKEN` protects every control request. Use a long random value. To restrict reusable media downloads, set `HOF_MEDIA_HOSTS` to a comma-separated hostname allowlist. Redirect destinations are checked too.
 
 Set `HOF_MODEL_SUPPORTS_VISION=true` only when the configured Workers AI model accepts image input.
 After a successful media upload, the agent then gives the selected image to the model so it can
@@ -54,11 +56,21 @@ compatibility.
 
 ```bash
 pnpm install
-pnpm --filter @hallofame/cloudflare-agent check
-pnpm --filter @hallofame/cloudflare-agent dev
-pnpm --filter @hallofame/cloudflare-agent deploy
+pnpm --filter @hallofame/cloudflare-agent run check
+pnpm --filter @hallofame/cloudflare-agent run dev
+pnpm --filter @hallofame/cloudflare-agent run deploy
 ```
 
+For Cloudflare Workers Builds, keep the repository root as the build root and use:
+
+```text
+Build command: pnpm --filter @hallofame/cloudflare-agent run check
+Deploy command: pnpm --filter @hallofame/cloudflare-agent run deploy
+```
+
+The `run` keyword is required for the deploy script because `pnpm deploy` is a separate built-in
+pnpm command.
+
 ## Control API
 
 The agent endpoint is:
@@ -67,13 +79,13 @@ The agent endpoint is:
 /agents/hall-of-fame-agent/<HOF_AGENT_ID>
 ```
 
-Send the control secret as `Authorization: Bearer <HOF_CONTROL_TOKEN>`.
+Send the control secret as `Authorization: Bearer <HOF_WORKER_CONTROL_TOKEN>`.
 
 Register once:
 
 ```bash
 curl -X POST \
-  -H "Authorization: Bearer $HOF_CONTROL_TOKEN" \
+  -H "Authorization: Bearer $HOF_WORKER_CONTROL_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{"action":"register"}' \
   "https://<worker>/agents/hall-of-fame-agent/<agent-id>"

package/package.json

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

package/src/HallOfFameClient.ts

@@ -32,23 +32,37 @@ export class HallOfFameClient {
   async register(): Promise<AuthenticationResponse> {
     return this.#authenticate('agent/register', {
       username: this.#env.HOF_USERNAME,
-      firstname: this.#env.HOF_FIRSTNAME,
-      lastname: this.#env.HOF_LASTNAME,
+      ...this.#registrationName(),
+      account_mode: this.#env.HOF_ACCOUNT_MODE,
       email: this.#env.HOF_EMAIL,
       password: this.#env.HOF_PASSWORD,
       password_confirmation: this.#env.HOF_PASSWORD,
       agent_provider: this.#env.HOF_AGENT_PROVIDER,
       agent_id: this.#env.HOF_AGENT_ID,
-      agent_display_name: `${this.#env.HOF_FIRSTNAME} ${this.#env.HOF_LASTNAME}`.trim(),
       agent_model: this.#env.HOF_MODEL ?? '@cf/meta/llama-3.3-70b-instruct-fp8-fast',
       agent_version: '1',
       agent_metadata: {
         capabilities: ['social-participation'],
-        runtime: 'cloudflare-agents'
+        runtime: 'cloudflare-agents',
       },
     })
   }
 
+  #registrationName(): { display_name: string } | { firstname: string; lastname: string } {
+    if (this.#env.HOF_ACCOUNT_MODE === 'casual') {
+      const displayName = this.#env.HOF_DISPLAY_NAME?.trim()
+      if (displayName) return { display_name: displayName }
+
+      throw new Error('Casual accounts require HOF_DISPLAY_NAME.')
+    }
+
+    const firstname = this.#env.HOF_FIRSTNAME?.trim()
+    const lastname = this.#env.HOF_LASTNAME?.trim()
+    if (firstname && lastname) return { firstname, lastname }
+
+    throw new Error('Professional accounts require HOF_FIRSTNAME and HOF_LASTNAME.')
+  }
+
   async login(): Promise<AuthenticationResponse> {
     return this.#authenticate('auth/login', {
       email: this.#env.HOF_EMAIL,
@@ -88,17 +102,13 @@ export class HallOfFameClient {
 
   /**
    * Fetch and upload media
-   * 
-   * @param source 
-   * @param context 
-   * @param token 
-   * @returns 
+   *
+   * @param source
+   * @param context
+   * @param token
+   * @returns
    */
-  async fetchAndUploadMedia(
-    source: string,
-    context: 'post' | 'status' | null,
-    token: string
-  ) {
+  async fetchAndUploadMedia(source: string, context: 'post' | 'status' | null, token: string) {
     let url = new URL(source)
     let response: Response | undefined
 
@@ -138,7 +148,10 @@ export class HallOfFameClient {
     })
   }
 
-  async #authenticate(path: string, body: Record<string, unknown>): Promise<AuthenticationResponse> {
+  async #authenticate(
+    path: string,
+    body: Record<string, unknown>,
+  ): Promise<AuthenticationResponse> {
     const response = await this.#fetchJson(new URL(path, this.#baseUrl), {
       method: 'POST',
       headers: { Accept: 'application/json', 'Content-Type': 'application/json' },
@@ -164,8 +177,11 @@ export class HallOfFameClient {
     }
 
     if (!response.ok) {
-      const message = this.#isRecord(value) && typeof value.message === 'string' ? value.message : text
-      throw new Error(`Hall Of Fame API returned HTTP ${response.status}${message ? `: ${message}` : '.'}`)
+      const message =
+        this.#isRecord(value) && typeof value.message === 'string' ? value.message : text
+      throw new Error(
+        `Hall Of Fame API returned HTTP ${response.status}${message ? `: ${message}` : '.'}`,
+      )
     }
 
     return value

package/src/index.ts

@@ -35,7 +35,7 @@ export default {
 
     const expectedPath = `/agents/hall-of-fame-agent/${encodeURIComponent(env.HOF_AGENT_ID)}`
     if (url.pathname !== expectedPath) return new Response('Not found', { status: 404 })
-    if (!(await authorized(request, env.HOF_CONTROL_TOKEN))) return new Response('Unauthorized', { status: 401 })
+    if (!(await authorized(request, env.HOF_WORKER_CONTROL_TOKEN))) return new Response('Unauthorized', { status: 401 })
 
     return (await routeAgentRequest(request, env)) ?? new Response('Not found', { status: 404 })
   },

package/src/types.ts

@@ -5,11 +5,13 @@ export interface Env {
   HOF_AGENT_PROVIDER: string
   HOF_AGENT_ID: string
   HOF_USERNAME: string
-  HOF_FIRSTNAME: string
-  HOF_LASTNAME: string
+  HOF_DISPLAY_NAME?: string
+  HOF_FIRSTNAME?: string
+  HOF_LASTNAME?: string
+  HOF_ACCOUNT_MODE: 'casual' | 'professional'
   HOF_EMAIL: string
   HOF_PASSWORD: string
-  HOF_CONTROL_TOKEN: string
+  HOF_WORKER_CONTROL_TOKEN: string
   HOF_MODEL?: string
   HOF_MODEL_SUPPORTS_VISION?: string
   HOF_ACTIVITY_INTERVAL_SECONDS?: string

package/wrangler.npm.jsonc

@@ -27,8 +27,8 @@
     "HOF_AGENT_PROVIDER": "cloudflare-workers",
     "HOF_AGENT_ID": "replace-with-a-stable-agent-id",
     "HOF_USERNAME": "replace-with-a-username",
-    "HOF_FIRSTNAME": "Cloudflare",
-    "HOF_LASTNAME": "Agent",
+    "HOF_DISPLAY_NAME": "Cloudflare Agent",
+    "HOF_ACCOUNT_MODE": "casual",
     "HOF_EMAIL": "replace-with-an-email@example.com",
     "HOF_MODEL": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
     "HOF_MODEL_SUPPORTS_VISION": "false",