spora 0.7.1 → 0.7.3

package/dist/client-4KGOBIXE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/x-client/api/client.ts"],"sourcesContent":["import { TwitterApi } from \"twitter-api-v2\";\nimport { loadCredentials } from \"../../utils/crypto.js\";\nimport { logger } from \"../../utils/logger.js\";\nimport { loadIdentity, identityExists } from \"../../identity/index.js\";\nimport { logInteraction } from \"../../memory/index.js\";\nimport { rateLimiter } from \"../rate-limiter.js\";\nimport type {\n  XClientInterface,\n  Tweet,\n  UserProfile,\n  PostResult,\n  TimelineOptions,\n  SearchOptions,\n} from \"../types.js\";\n\ninterface TwitterResponseMeta {\n  next_token?: string;\n}\n\ninterface TwitterUser {\n  id: string;\n  username: string;\n  name?: string;\n  description?: string;\n  verified?: boolean;\n  profile_image_url?: string;\n  public_metrics?: {\n    followers_count?: number;\n    following_count?: number;\n    tweet_count?: number;\n  };\n}\n\ninterface TwitterTweet {\n  id: string;\n  text: string;\n  author_id?: string;\n  created_at?: string;\n  in_reply_to_user_id?: string;\n  public_metrics?: {\n    like_count?: number;\n    retweet_count?: number;\n    reply_count?: number;\n  };\n}\n\ninterface TwitterTimelineResponse {\n  data?: TwitterTweet[];\n  includes?: {\n    users?: TwitterUser[];\n  };\n  meta?: TwitterResponseMeta;\n}\n\n/**\n * Extract useful error details from twitter-api-v2 errors.\n * Their ApiResponseError has .code, .data, .errors properties that JSON.stringify misses.\n */\nfunction extractTwitterError(error: unknown): string {\n  if (!error || typeof error !== \"object\") return String(error);\n  const e = error as Record<string, unknown>;\n\n  // twitter-api-v2 ApiResponseError shape\n  if (e.code && e.data) {\n    const status = e.code;\n    const data = e.data as Record<string, unknown>;\n    const errors = (data.errors ?? data.detail ?? data.title ?? data.reason) as unknown;\n    return `HTTP ${status}: ${JSON.stringify(errors ?? data)}`;\n  }\n\n  // Fallback for standard errors\n  if (e.message) return e.message as string;\n  return String(error);\n}\n\nexport class XApiClient implements XClientInterface {\n  private readonly readWrite: TwitterApi;\n  private readonly readOnly: TwitterApi;\n  private meId: string | null = null;\n  private creds: ReturnType<typeof loadCredentials>;\n\n  constructor() {\n    this.creds = loadCredentials();\n    if (this.creds.method !== \"api\") {\n      throw new Error(\"Only API credentials are supported.\");\n    }\n\n    if (!this.creds.apiKey || !this.creds.apiSecret || !this.creds.accessToken || !this.creds.accessTokenSecret) {\n      throw new Error(\"Missing X OAuth credentials. Run `spora init` and provide API keys.\");\n    }\n\n    this.readWrite = new TwitterApi({\n      appKey: this.creds.apiKey,\n      appSecret: this.creds.apiSecret,\n      accessToken: this.creds.accessToken,\n      accessSecret: this.creds.accessTokenSecret,\n    });\n\n    // Use user-context auth for all reads in runtime.\n    // Some endpoints we rely on (timeline/mentions) reject OAuth2 app-only auth.\n    this.readOnly = this.readWrite;\n  }\n\n  private toTweet(tweet: TwitterTweet, userMap: Map<string, string>): Tweet {\n    const authorId = tweet.author_id ?? \"unknown\";\n    return {\n      id: tweet.id,\n      text: tweet.text,\n      authorId,\n      authorHandle: userMap.get(authorId) ?? \"unknown\",\n      createdAt: tweet.created_at ?? new Date().toISOString(),\n      likeCount: tweet.public_metrics?.like_count,\n      retweetCount: tweet.public_metrics?.retweet_count,\n      replyCount: tweet.public_metrics?.reply_count,\n      inReplyToId: tweet.in_reply_to_user_id,\n    };\n  }\n\n  /**\n   * 3-strategy approach to resolve the authenticated user's ID.\n   * 1. Extract from OAuth access token (format: {userId}-{rest})\n   * 2. Use /2/users/me endpoint\n   * 3. Fall back to userByUsername lookup\n   */\n  private async getUserId(): Promise<string> {\n    if (this.meId) return this.meId;\n\n    // Strategy 1: Extract user ID from OAuth access token (format: {userId}-{rest})\n    const accessToken = this.creds.accessToken;\n    if (accessToken) {\n      const dashIdx = accessToken.indexOf(\"-\");\n      if (dashIdx > 0) {\n        const candidate = accessToken.substring(0, dashIdx);\n        if (/^\\d+$/.test(candidate)) {\n          logger.info(`User ID extracted from access token: ${candidate}`);\n          this.meId = candidate;\n          return this.meId;\n        }\n      }\n    }\n\n    // Strategy 2: Use /2/users/me endpoint\n    try {\n      const me = (await this.readWrite.v2.me({\n        \"user.fields\": [\"id\"],\n      })) as { data?: { id: string; username?: string } };\n\n      if (me.data?.id) {\n        logger.info(`User ID from /me endpoint: ${me.data.id}${me.data.username ? ` (@${me.data.username})` : \"\"}`);\n        this.meId = me.data.id;\n        return this.meId;\n      }\n    } catch (err) {\n      logger.warn(`/me endpoint failed: ${extractTwitterError(err)}`);\n    }\n\n    // Strategy 3: Fall back to username lookup\n    const handle = this.getHandle();\n    logger.info(`Trying userByUsername lookup for: ${handle}`);\n    const result = await this.readOnly.v2.userByUsername(handle);\n    if (!(result as { data?: { id: string } }).data) {\n      const errInfo = (result as Record<string, unknown>).errors;\n      throw new Error(\n        `Could not find user @${handle}. API returned: ${JSON.stringify(errInfo ?? \"no data\")}`\n      );\n    }\n    this.meId = (result as { data: { id: string } }).data.id;\n    return this.meId;\n  }\n\n  private getHandle(): string {\n    let handle: string | undefined;\n    if (identityExists()) {\n      handle = loadIdentity().handle;\n    } else {\n      handle = this.creds.username;\n    }\n    if (!handle) throw new Error(\"No handle found. Create a Spore identity first.\");\n    // Strip @ prefix — twitter-api-v2 userByUsername expects bare handle\n    return handle.replace(/^@/, \"\");\n  }\n\n  private normalizeHandleOrId(input: string): { isId: boolean; value: string } {\n    const cleaned = input.trim().replace(/^@/, \"\");\n    const isId = /^\\d+$/.test(cleaned);\n    return { isId, value: cleaned };\n  }\n\n  private async resolveUserId(handleOrId: string): Promise<string> {\n    const parsed = this.normalizeHandleOrId(handleOrId);\n    if (parsed.isId) return parsed.value;\n\n    const user = (await this.readOnly.v2.userByUsername(parsed.value, {\n      \"user.fields\": [\"id\", \"username\"],\n    })) as { data?: { id: string } };\n\n    if (!user.data?.id) {\n      throw new Error(`Could not resolve @${parsed.value} to a user ID`);\n    }\n\n    return user.data.id;\n  }\n\n  private buildUserMap(users: TwitterUser[] | undefined): Map<string, string> {\n    const map = new Map<string, string>();\n    for (const user of users ?? []) {\n      map.set(user.id, user.username);\n    }\n    return map;\n  }\n\n  async postTweet(content: string): Promise<PostResult> {\n    if (!rateLimiter.canPost()) {\n      return { success: false, error: \"Monthly post limit reached\" };\n    }\n\n    try {\n      const response = (await this.readWrite.v2.tweet(content)) as { data?: { id?: string } };\n      const tweetId = response.data?.id;\n\n      if (!tweetId) {\n        return { success: false, error: \"X API did not return a tweet ID.\" };\n      }\n\n      rateLimiter.consume(1);\n      logInteraction({\n        id: `int-${Date.now()}`,\n        timestamp: new Date().toISOString(),\n        type: \"post\",\n        tweetId,\n        content,\n        creditsUsed: 1,\n        success: true,\n      });\n\n      return { success: true, tweetId };\n    } catch (error) {\n      const detail = extractTwitterError(error);\n      logger.error(`Failed to post tweet: ${detail}`);\n      return { success: false, error: detail };\n    }\n  }\n\n  async replyToTweet(tweetId: string, content: string): Promise<PostResult> {\n    if (!rateLimiter.canPost()) {\n      return { success: false, error: \"Monthly post limit reached\" };\n    }\n\n    try {\n      const response = (await this.readWrite.v2.reply(content, tweetId)) as {\n        data?: { id?: string };\n      };\n      const createdId = response.data?.id;\n\n      if (!createdId) {\n        return { success: false, error: \"X API did not return a reply ID.\" };\n      }\n\n      rateLimiter.consume(1);\n      logInteraction({\n        id: `int-${Date.now()}`,\n        timestamp: new Date().toISOString(),\n        type: \"reply\",\n        tweetId: createdId,\n        inReplyTo: tweetId,\n        content,\n        creditsUsed: 1,\n        success: true,\n      });\n\n      return { success: true, tweetId: createdId };\n    } catch (error) {\n      const detail = extractTwitterError(error);\n      logger.error(`Failed to reply: ${detail}`);\n      return { success: false, error: detail };\n    }\n  }\n\n  async deleteTweet(tweetId: string): Promise<PostResult> {\n    try {\n      await this.readWrite.v2.deleteTweet(tweetId);\n      return { success: true, tweetId };\n    } catch (error) {\n      return { success: false, error: (error as Error).message };\n    }\n  }\n\n  async likeTweet(tweetId: string): Promise<PostResult> {\n    try {\n      rateLimiter.requireBasicTier(\"Like\");\n      const meId = await this.getUserId();\n      await this.readWrite.v2.like(meId, tweetId);\n\n      logInteraction({\n        id: `int-${Date.now()}`,\n        timestamp: new Date().toISOString(),\n        type: \"like\",\n        tweetId,\n        creditsUsed: 0,\n        success: true,\n      });\n\n      return { success: true, tweetId };\n    } catch (error) {\n      return { success: false, error: (error as Error).message };\n    }\n  }\n\n  async unlikeTweet(tweetId: string): Promise<PostResult> {\n    try {\n      rateLimiter.requireBasicTier(\"Unlike\");\n      const meId = await this.getUserId();\n      await this.readWrite.v2.unlike(meId, tweetId);\n      return { success: true, tweetId };\n    } catch (error) {\n      return { success: false, error: (error as Error).message };\n    }\n  }\n\n  async retweet(tweetId: string): Promise<PostResult> {\n    try {\n      rateLimiter.requireBasicTier(\"Retweet\");\n      const meId = await this.getUserId();\n      await this.readWrite.v2.retweet(meId, tweetId);\n\n      logInteraction({\n        id: `int-${Date.now()}`,\n        timestamp: new Date().toISOString(),\n        type: \"retweet\",\n        tweetId,\n        creditsUsed: 0,\n        success: true,\n      });\n\n      return { success: true, tweetId };\n    } catch (error) {\n      return { success: false, error: (error as Error).message };\n    }\n  }\n\n  async unretweet(tweetId: string): Promise<PostResult> {\n    try {\n      rateLimiter.requireBasicTier(\"Unretweet\");\n      const meId = await this.getUserId();\n      await this.readWrite.v2.unretweet(meId, tweetId);\n      return { success: true, tweetId };\n    } catch (error) {\n      return { success: false, error: (error as Error).message };\n    }\n  }\n\n  async followUser(handleOrId: string): Promise<PostResult> {\n    rateLimiter.requireBasicTier(\"Follow\");\n    try {\n      const meId = await this.getUserId();\n      const targetId = await this.resolveUserId(handleOrId);\n      await this.readWrite.v2.follow(meId, targetId);\n\n      logInteraction({\n        id: `int-${Date.now()}`,\n        timestamp: new Date().toISOString(),\n        type: \"follow\",\n        targetUserId: targetId,\n        targetHandle: handleOrId.replace(/^@/, \"\"),\n        creditsUsed: 0,\n        success: true,\n      });\n\n      return { success: true };\n    } catch (error) {\n      return { success: false, error: (error as Error).message };\n    }\n  }\n\n  async unfollowUser(handleOrId: string): Promise<PostResult> {\n    rateLimiter.requireBasicTier(\"Unfollow\");\n    try {\n      const meId = await this.getUserId();\n      const targetId = await this.resolveUserId(handleOrId);\n      await this.readWrite.v2.unfollow(meId, targetId);\n      return { success: true };\n    } catch (error) {\n      return { success: false, error: (error as Error).message };\n    }\n  }\n\n  async getTimeline(options?: TimelineOptions): Promise<Tweet[]> {\n    try {\n      rateLimiter.requireBasicTier(\"Read timeline\");\n      const meId = await this.getUserId();\n\n      const response = (await this.readOnly.v2.get(\n        `users/${meId}/timelines/reverse_chronological`,\n        {\n          max_results: options?.count ?? 20,\n          since_id: options?.sinceId,\n          expansions: [\"author_id\"],\n          \"tweet.fields\": [\n            \"created_at\",\n            \"public_metrics\",\n            \"in_reply_to_user_id\",\n            \"author_id\",\n          ],\n          \"user.fields\": [\"username\"],\n        }\n      )) as TwitterTimelineResponse;\n\n      if (!response.data?.length) return [];\n\n      const users = this.buildUserMap(response.includes?.users);\n      return response.data.map((tweet) => this.toTweet(tweet, users));\n    } catch (error) {\n      const detail = extractTwitterError(error);\n      logger.error(`Failed to read timeline: ${detail}`);\n      return [];\n    }\n  }\n\n  async getMentions(options?: TimelineOptions): Promise<Tweet[]> {\n    try {\n      rateLimiter.requireBasicTier(\"Read mentions\");\n      const meId = await this.getUserId();\n      const response = (await this.readOnly.v2.get(`users/${meId}/mentions`, {\n        max_results: options?.count ?? 20,\n        since_id: options?.sinceId,\n        expansions: [\"author_id\"],\n        \"tweet.fields\": [\"created_at\", \"public_metrics\", \"author_id\"],\n        \"user.fields\": [\"username\"],\n      })) as TwitterTimelineResponse;\n\n      if (!response.data?.length) return [];\n\n      const users = this.buildUserMap(response.includes?.users);\n      return response.data.map((tweet) => this.toTweet(tweet, users));\n    } catch (error) {\n      const detail = extractTwitterError(error);\n      logger.error(`Failed to read mentions: ${detail}`);\n      return [];\n    }\n  }\n\n  async getUserTweets(userId: string, options?: TimelineOptions): Promise<Tweet[]> {\n    try {\n      rateLimiter.requireBasicTier(\"Read user tweets\");\n\n      const response = (await this.readOnly.v2.get(`users/${userId}/tweets`, {\n        max_results: options?.count ?? 10,\n        since_id: options?.sinceId,\n        expansions: [\"author_id\"],\n        \"tweet.fields\": [\"created_at\", \"public_metrics\", \"author_id\"],\n        \"user.fields\": [\"username\"],\n      })) as TwitterTimelineResponse;\n\n      if (!response.data?.length) return [];\n\n      const users = this.buildUserMap(response.includes?.users);\n      return response.data.map((tweet) => this.toTweet(tweet, users));\n    } catch (error) {\n      const detail = extractTwitterError(error);\n      logger.error(`Failed to read user tweets for ${userId}: ${detail}`);\n      return [];\n    }\n  }\n\n  async searchTweets(query: string, options?: SearchOptions): Promise<Tweet[]> {\n    try {\n      rateLimiter.requireBasicTier(\"Search tweets\");\n      const paginator = await this.readOnly.v2.search(query, {\n        max_results: Math.min(options?.count ?? 20, 100),\n        expansions: [\"author_id\"],\n        \"tweet.fields\": [\"created_at\", \"public_metrics\", \"author_id\"],\n        \"user.fields\": [\"username\"],\n      });\n\n      const tweets: TwitterTweet[] = [];\n      const users = new Map<string, string>();\n\n      for await (const tweet of paginator) {\n        tweets.push(tweet as unknown as TwitterTweet);\n        if (tweets.length >= (options?.count ?? 20)) break;\n      }\n\n      const includeUsers = (paginator as unknown as { includes?: { users?: TwitterUser[] } }).includes?.users;\n      for (const user of includeUsers ?? []) {\n        users.set(user.id, user.username);\n      }\n\n      return tweets.map((tweet) => this.toTweet(tweet, users));\n    } catch (error) {\n      const detail = extractTwitterError(error);\n      logger.error(`Failed to search tweets: ${detail}`);\n      return [];\n    }\n  }\n\n  async getProfile(handle: string): Promise<UserProfile> {\n    rateLimiter.requireBasicTier(\"Get profile\");\n\n    const cleanedHandle = handle.trim().replace(/^@/, \"\");\n    const response = (await this.readOnly.v2.userByUsername(cleanedHandle, {\n      \"user.fields\": [\n        \"description\",\n        \"public_metrics\",\n        \"verified\",\n        \"profile_image_url\",\n        \"username\",\n        \"name\",\n      ],\n    })) as { data?: TwitterUser };\n\n    if (!response.data) {\n      throw new Error(`Profile not found for @${cleanedHandle}`);\n    }\n\n    return {\n      id: response.data.id,\n      handle: response.data.username,\n      name: response.data.name ?? response.data.username,\n      bio: response.data.description ?? \"\",\n      followersCount: response.data.public_metrics?.followers_count ?? 0,\n      followingCount: response.data.public_metrics?.following_count ?? 0,\n      tweetCount: response.data.public_metrics?.tweet_count ?? 0,\n      verified: response.data.verified ?? false,\n      profileImageUrl: response.data.profile_image_url,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{colony-JPZC3R34.js → colony-IVYR233C.js}

@@ -10,13 +10,13 @@ import {
 } from "./chunk-T7L2L7ZL.js";
 import {
   getXClient
-} from "./chunk-E5NR6HT4.js";
+} from "./chunk-HGNMHGAF.js";
 import {
   loadIdentity
 } from "./chunk-M6YOQVSI.js";
 import {
   logger
-} from "./chunk-NPV3OV2K.js";
+} from "./chunk-YMGJQRKG.js";
 import "./chunk-NO3NQN67.js";
 import "./chunk-3RYCUGXE.js";
 
@@ -226,4 +226,4 @@ export {
   postStatus,
   proposePlan
 };
-//# sourceMappingURL=colony-JPZC3R34.js.map
+//# sourceMappingURL=colony-IVYR233C.js.map

package/dist/{heartbeat-TNEPE3ZP.js → heartbeat-CUL2FTFD.js}

@@ -1,23 +1,34 @@
 import {
   runAutonomyCycle
-} from "./chunk-WIK74GGJ.js";
-import "./chunk-E5NR6HT4.js";
+} from "./chunk-ZBP2ROAZ.js";
+import "./chunk-HGNMHGAF.js";
 import {
   flushQueue
-} from "./chunk-OACD3HGE.js";
-import "./chunk-AOQ3WLZV.js";
-import "./chunk-P6KZIJYL.js";
+} from "./chunk-7OOGNZBU.js";
+import {
+  buildReflectionPrompt
+} from "./chunk-Q3YXJ2C6.js";
+import {
+  loadStrategy,
+  saveStrategy
+} from "./chunk-P6KZIJYL.js";
 import "./chunk-WN35MRMF.js";
-import "./chunk-LXQNVVIY.js";
-import "./chunk-M6YOQVSI.js";
-import "./chunk-KWWAIS3C.js";
+import "./chunk-4LNMA56H.js";
+import {
+  loadIdentity
+} from "./chunk-M6YOQVSI.js";
+import {
+  generateResponse
+} from "./chunk-SUZUJGGW.js";
 import {
   logger
-} from "./chunk-NPV3OV2K.js";
+} from "./chunk-YMGJQRKG.js";
 import {
   loadConfig
 } from "./chunk-NO3NQN67.js";
-import "./chunk-JBYZ7K56.js";
+import {
+  addLearning
+} from "./chunk-JBYZ7K56.js";
 import {
   ensureDirectories,
   paths
@@ -137,7 +148,7 @@ Spora agent is running (PID ${process.pid})`);
     heartbeatCount++;
     logger.info(`=== Heartbeat #${heartbeatCount} ===`);
     try {
-      await runHeartbeat(maxActions);
+      await runHeartbeat(maxActions, heartbeatCount);
     } catch (error) {
       logger.error("Heartbeat error", error);
       console.error(`Heartbeat #${heartbeatCount} failed: ${error.message}`);
@@ -164,7 +175,7 @@ Spora agent is running (PID ${process.pid})`);
   logger.info("Spora agent stopped.");
   console.log("\nSpora agent stopped.");
 }
-async function runHeartbeat(maxActions) {
+async function runHeartbeat(maxActions, heartbeatCount) {
   logger.info("Checking queue...");
   try {
     const flushed = await flushQueue();
@@ -202,6 +213,39 @@ async function runHeartbeat(maxActions) {
     `Metrics: interactionRatio=${metrics.interactionRatio.toFixed(2)}, repeatedFormatRate=${metrics.repeatedFormatRate.toFixed(2)}`
   );
   logger.info(`Heartbeat complete. ${cycle.results.filter((r) => r.success).length}/${cycle.results.length} actions succeeded.`);
+  if (heartbeatCount % 3 === 0) {
+    try {
+      logger.info("Running reflection phase...");
+      const reflectionPrompt = buildReflectionPrompt(cycle.results);
+      const reflectionResponse = await generateResponse(
+        `You are ${loadIdentity().name}. Reflect honestly on your performance.`,
+        reflectionPrompt
+      );
+      const jsonMatch = reflectionResponse.content.match(/\{[\s\S]*\}/);
+      if (jsonMatch) {
+        try {
+          const reflection = JSON.parse(jsonMatch[0]);
+          if (reflection.learning && reflection.learning !== "null") {
+            addLearning(reflection.learning, "reflection", ["heartbeat", "performance"]);
+            logger.info(`Reflection learning: ${reflection.learning}`);
+          }
+          if (reflection.strategyUpdate && reflection.strategyUpdate !== "null") {
+            const strategy = loadStrategy();
+            strategy.experiments.push({
+              description: reflection.strategyUpdate,
+              status: "pending"
+            });
+            strategy.lastUpdated = (/* @__PURE__ */ new Date()).toISOString();
+            saveStrategy(strategy);
+            logger.info(`Strategy update: ${reflection.strategyUpdate}`);
+          }
+        } catch {
+        }
+      }
+    } catch (err) {
+      logger.warn(`Reflection failed: ${err.message}`);
+    }
+  }
 }
 export {
   getRunningPid,
@@ -209,4 +253,4 @@ export {
   requestStop,
   startHeartbeatLoop
 };
-//# sourceMappingURL=heartbeat-TNEPE3ZP.js.map
+//# sourceMappingURL=heartbeat-CUL2FTFD.js.map

package/dist/heartbeat-CUL2FTFD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/heartbeat.ts","../src/runtime/telemetry.ts"],"sourcesContent":["import { existsSync, unlinkSync, writeFileSync, readFileSync } from \"node:fs\";\nimport { logger } from \"../utils/logger.js\";\nimport { loadConfig } from \"../utils/config.js\";\nimport { paths } from \"../utils/paths.js\";\nimport { flushQueue } from \"../scheduler/queue.js\";\nimport { runAutonomyCycle } from \"./autonomy.js\";\nimport { writeHeartbeatMetrics } from \"./telemetry.js\";\nimport { buildReflectionPrompt } from \"./prompt-builder.js\";\nimport { generateResponse } from \"./llm.js\";\nimport { addLearning } from \"../memory/index.js\";\nimport { loadStrategy, saveStrategy } from \"../memory/strategy.js\";\nimport { loadIdentity } from \"../identity/index.js\";\n\nlet running = false;\n\nexport function isRunning(): boolean {\n  return running;\n}\n\nexport function requestStop(): void {\n  writeFileSync(paths.stopSignal, \"stop\");\n  logger.info(\"Stop signal sent.\");\n}\n\nfunction shouldStop(): boolean {\n  if (existsSync(paths.stopSignal)) {\n    unlinkSync(paths.stopSignal);\n    return true;\n  }\n  return false;\n}\n\nfunction writePid(): void {\n  writeFileSync(paths.runtimePid, String(process.pid));\n}\n\nfunction clearPid(): void {\n  if (existsSync(paths.runtimePid)) {\n    unlinkSync(paths.runtimePid);\n  }\n}\n\nexport function getRunningPid(): number | null {\n  if (!existsSync(paths.runtimePid)) return null;\n  const pid = parseInt(readFileSync(paths.runtimePid, \"utf-8\").trim(), 10);\n  if (isNaN(pid)) return null;\n\n  // Check if process is actually running\n  try {\n    process.kill(pid, 0);\n    return pid;\n  } catch {\n    // Process not running, clean up stale PID\n    clearPid();\n    return null;\n  }\n}\n\nexport async function startHeartbeatLoop(): Promise<void> {\n  // Check if already running\n  const existingPid = getRunningPid();\n  if (existingPid) {\n    throw new Error(`Spora is already running (PID ${existingPid}). Run \\`spora stop\\` first.`);\n  }\n\n  running = true;\n  writePid();\n\n  const config = loadConfig();\n  const intervalMs = config.runtime?.heartbeatIntervalMs ?? 300_000;\n  const maxActions = config.runtime?.actionsPerHeartbeat ?? 3;\n\n  logger.info(`Spora agent starting. Heartbeat interval: ${intervalMs / 1000}s, max actions: ${maxActions}`);\n  console.log(`\\nSpora agent is running (PID ${process.pid})`);\n  console.log(`Heartbeat every ${Math.round(intervalMs / 60_000)} minutes`);\n  console.log(`Press Ctrl+C or run \\`spora stop\\` to stop.\\n`);\n\n  // Handle graceful shutdown\n  const shutdown = () => {\n    logger.info(\"Shutting down...\");\n    running = false;\n    clearPid();\n    process.exit(0);\n  };\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n\n  // Clean any stale stop signal\n  if (existsSync(paths.stopSignal)) {\n    unlinkSync(paths.stopSignal);\n  }\n\n  let heartbeatCount = 0;\n\n  while (running) {\n    heartbeatCount++;\n    logger.info(`=== Heartbeat #${heartbeatCount} ===`);\n\n    try {\n      await runHeartbeat(maxActions, heartbeatCount);\n    } catch (error) {\n      logger.error(\"Heartbeat error\", error);\n      console.error(`Heartbeat #${heartbeatCount} failed: ${(error as Error).message}`);\n    }\n\n    // Check for stop signal\n    if (shouldStop()) {\n      logger.info(\"Stop signal received.\");\n      break;\n    }\n\n    // Sleep with jitter\n    const jitter = Math.floor(Math.random() * intervalMs * 0.3);\n    const sleepMs = intervalMs + jitter;\n    logger.info(`Sleeping ${Math.round(sleepMs / 1000)}s until next heartbeat...`);\n\n    // Sleep in chunks so we can check for stop signals\n    const chunkMs = 10_000;\n    let slept = 0;\n    while (slept < sleepMs && running) {\n      await new Promise((r) => setTimeout(r, Math.min(chunkMs, sleepMs - slept)));\n      slept += chunkMs;\n      if (shouldStop()) {\n        running = false;\n        break;\n      }\n    }\n  }\n\n  clearPid();\n  logger.info(\"Spora agent stopped.\");\n  console.log(\"\\nSpora agent stopped.\");\n}\n\nasync function runHeartbeat(maxActions: number, heartbeatCount: number): Promise<void> {\n  // 1. Flush any queued posts\n  logger.info(\"Checking queue...\");\n  try {\n    const flushed = await flushQueue();\n    if (flushed.posted > 0) {\n      logger.info(`Flushed ${flushed.posted} queued posts.`);\n    }\n  } catch (error) {\n    logger.warn(`Queue flush failed: ${(error as Error).message}`);\n  }\n\n  // 2. Run planner/executor cycle.\n  const cycle = await runAutonomyCycle(maxActions);\n  logger.info(`Observed ${cycle.timeline.length} timeline posts and ${cycle.mentions.length} mentions.`);\n\n  if (cycle.actions.length === 0) {\n    logger.info(\"Planner returned no approved actions.\");\n    return;\n  }\n\n  logger.info(`Executed ${cycle.results.length} action(s).`);\n\n  // 3. Log results\n  for (const result of cycle.results) {\n    if (result.success) {\n      logger.info(`  [OK] ${result.action}${result.detail ? `: ${result.detail}` : \"\"}`);\n    } else {\n      logger.warn(`  [FAIL] ${result.action}: ${result.error}`);\n    }\n  }\n\n  for (const note of cycle.policyFeedback) {\n    logger.info(`  [POLICY] ${note}`);\n  }\n\n  const metrics = writeHeartbeatMetrics({\n    timelineCount: cycle.timeline.length,\n    mentionsCount: cycle.mentions.length,\n    actions: cycle.actions,\n    results: cycle.results,\n    policyFeedbackCount: cycle.policyFeedback.length,\n  });\n  logger.info(\n    `Metrics: interactionRatio=${metrics.interactionRatio.toFixed(2)}, repeatedFormatRate=${metrics.repeatedFormatRate.toFixed(2)}`\n  );\n\n  logger.info(`Heartbeat complete. ${cycle.results.filter((r) => r.success).length}/${cycle.results.length} actions succeeded.`);\n\n  // Reflection phase — every 3rd heartbeat\n  if (heartbeatCount % 3 === 0) {\n    try {\n      logger.info(\"Running reflection phase...\");\n      const reflectionPrompt = buildReflectionPrompt(cycle.results);\n      const reflectionResponse = await generateResponse(\n        `You are ${loadIdentity().name}. Reflect honestly on your performance.`,\n        reflectionPrompt,\n      );\n\n      const jsonMatch = reflectionResponse.content.match(/\\{[\\s\\S]*\\}/);\n      if (jsonMatch) {\n        try {\n          const reflection = JSON.parse(jsonMatch[0]);\n          if (reflection.learning && reflection.learning !== \"null\") {\n            addLearning(reflection.learning, \"reflection\", [\"heartbeat\", \"performance\"]);\n            logger.info(`Reflection learning: ${reflection.learning}`);\n          }\n          if (reflection.strategyUpdate && reflection.strategyUpdate !== \"null\") {\n            const strategy = loadStrategy();\n            strategy.experiments.push({\n              description: reflection.strategyUpdate,\n              status: \"pending\",\n            });\n            strategy.lastUpdated = new Date().toISOString();\n            saveStrategy(strategy);\n            logger.info(`Strategy update: ${reflection.strategyUpdate}`);\n          }\n        } catch {\n          // Couldn't parse reflection JSON\n        }\n      }\n    } catch (err) {\n      logger.warn(`Reflection failed: ${(err as Error).message}`);\n    }\n  }\n}\n","import { appendFileSync } from \"node:fs\";\nimport { paths, ensureDirectories } from \"../utils/paths.js\";\nimport type { AgentAction, ActionResult } from \"./decision-engine.js\";\n\nexport interface HeartbeatMetrics {\n  timestamp: string;\n  timelineCount: number;\n  mentionsCount: number;\n  actionCount: number;\n  successCount: number;\n  postCount: number;\n  interactionCount: number;\n  interactionRatio: number;\n  repeatedFormatRate: number;\n  policyRejectionCount: number;\n}\n\nfunction normalize(text: string): string {\n  return text.toLowerCase().replace(/[^a-z0-9\\s]/g, \" \").replace(/\\s+/g, \" \").trim();\n}\n\nfunction prefix(text: string, n = 6): string {\n  return normalize(text).split(\" \").filter(Boolean).slice(0, n).join(\" \");\n}\n\nfunction repeatedFormatRate(actions: AgentAction[]): number {\n  const posts = actions\n    .filter((action) => action.action === \"post\" && action.content)\n    .map((action) => action.content ?? \"\");\n\n  if (posts.length <= 1) return 0;\n\n  const seen = new Map<string, number>();\n  for (const content of posts) {\n    const key = prefix(content);\n    seen.set(key, (seen.get(key) ?? 0) + 1);\n  }\n\n  let repeated = 0;\n  for (const count of seen.values()) {\n    if (count > 1) repeated += count;\n  }\n\n  return repeated / posts.length;\n}\n\nexport function writeHeartbeatMetrics(input: {\n  timelineCount: number;\n  mentionsCount: number;\n  actions: AgentAction[];\n  results: ActionResult[];\n  policyFeedbackCount: number;\n}): HeartbeatMetrics {\n  const interactionCount = input.actions.filter((a) => [\"reply\", \"like\", \"retweet\", \"follow\"].includes(a.action)).length;\n  const postCount = input.actions.filter((a) => a.action === \"post\").length;\n  const successCount = input.results.filter((r) => r.success).length;\n\n  const metrics: HeartbeatMetrics = {\n    timestamp: new Date().toISOString(),\n    timelineCount: input.timelineCount,\n    mentionsCount: input.mentionsCount,\n    actionCount: input.actions.length,\n    successCount,\n    postCount,\n    interactionCount,\n    interactionRatio: input.actions.length > 0 ? interactionCount / input.actions.length : 0,\n    repeatedFormatRate: repeatedFormatRate(input.actions),\n    policyRejectionCount: input.policyFeedbackCount,\n  };\n\n  ensureDirectories();\n  appendFileSync(paths.runtimeMetrics, JSON.stringify(metrics) + \"\\n\");\n  return metrics;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,YAAY,YAAY,eAAe,oBAAoB;;;ACApE,SAAS,sBAAsB;AAiB/B,SAAS,UAAU,MAAsB;AACvC,SAAO,KAAK,YAAY,EAAE,QAAQ,gBAAgB,GAAG,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACnF;AAEA,SAAS,OAAO,MAAc,IAAI,GAAW;AAC3C,SAAO,UAAU,IAAI,EAAE,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG;AACxE;AAEA,SAAS,mBAAmB,SAAgC;AAC1D,QAAM,QAAQ,QACX,OAAO,CAAC,WAAW,OAAO,WAAW,UAAU,OAAO,OAAO,EAC7D,IAAI,CAAC,WAAW,OAAO,WAAW,EAAE;AAEvC,MAAI,MAAM,UAAU,EAAG,QAAO;AAE9B,QAAM,OAAO,oBAAI,IAAoB;AACrC,aAAW,WAAW,OAAO;AAC3B,UAAM,MAAM,OAAO,OAAO;AAC1B,SAAK,IAAI,MAAM,KAAK,IAAI,GAAG,KAAK,KAAK,CAAC;AAAA,EACxC;AAEA,MAAI,WAAW;AACf,aAAW,SAAS,KAAK,OAAO,GAAG;AACjC,QAAI,QAAQ,EAAG,aAAY;AAAA,EAC7B;AAEA,SAAO,WAAW,MAAM;AAC1B;AAEO,SAAS,sBAAsB,OAMjB;AACnB,QAAM,mBAAmB,MAAM,QAAQ,OAAO,CAAC,MAAM,CAAC,SAAS,QAAQ,WAAW,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE;AAChH,QAAM,YAAY,MAAM,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,EAAE;AACnE,QAAM,eAAe,MAAM,QAAQ,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE;AAE5D,QAAM,UAA4B;AAAA,IAChC,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC,eAAe,MAAM;AAAA,IACrB,eAAe,MAAM;AAAA,IACrB,aAAa,MAAM,QAAQ;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,IACA,kBAAkB,MAAM,QAAQ,SAAS,IAAI,mBAAmB,MAAM,QAAQ,SAAS;AAAA,IACvF,oBAAoB,mBAAmB,MAAM,OAAO;AAAA,IACpD,sBAAsB,MAAM;AAAA,EAC9B;AAEA,oBAAkB;AAClB,iBAAe,MAAM,gBAAgB,KAAK,UAAU,OAAO,IAAI,IAAI;AACnE,SAAO;AACT;;;AD5DA,IAAI,UAAU;AAEP,SAAS,YAAqB;AACnC,SAAO;AACT;AAEO,SAAS,cAAoB;AAClC,gBAAc,MAAM,YAAY,MAAM;AACtC,SAAO,KAAK,mBAAmB;AACjC;AAEA,SAAS,aAAsB;AAC7B,MAAI,WAAW,MAAM,UAAU,GAAG;AAChC,eAAW,MAAM,UAAU;AAC3B,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,WAAiB;AACxB,gBAAc,MAAM,YAAY,OAAO,QAAQ,GAAG,CAAC;AACrD;AAEA,SAAS,WAAiB;AACxB,MAAI,WAAW,MAAM,UAAU,GAAG;AAChC,eAAW,MAAM,UAAU;AAAA,EAC7B;AACF;AAEO,SAAS,gBAA+B;AAC7C,MAAI,CAAC,WAAW,MAAM,UAAU,EAAG,QAAO;AAC1C,QAAM,MAAM,SAAS,aAAa,MAAM,YAAY,OAAO,EAAE,KAAK,GAAG,EAAE;AACvE,MAAI,MAAM,GAAG,EAAG,QAAO;AAGvB,MAAI;AACF,YAAQ,KAAK,KAAK,CAAC;AACnB,WAAO;AAAA,EACT,QAAQ;AAEN,aAAS;AACT,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,qBAAoC;AAExD,QAAM,cAAc,cAAc;AAClC,MAAI,aAAa;AACf,UAAM,IAAI,MAAM,iCAAiC,WAAW,8BAA8B;AAAA,EAC5F;AAEA,YAAU;AACV,WAAS;AAET,QAAM,SAAS,WAAW;AAC1B,QAAM,aAAa,OAAO,SAAS,uBAAuB;AAC1D,QAAM,aAAa,OAAO,SAAS,uBAAuB;AAE1D,SAAO,KAAK,6CAA6C,aAAa,GAAI,mBAAmB,UAAU,EAAE;AACzG,UAAQ,IAAI;AAAA,8BAAiC,QAAQ,GAAG,GAAG;AAC3D,UAAQ,IAAI,mBAAmB,KAAK,MAAM,aAAa,GAAM,CAAC,UAAU;AACxE,UAAQ,IAAI;AAAA,CAA+C;AAG3D,QAAM,WAAW,MAAM;AACrB,WAAO,KAAK,kBAAkB;AAC9B,cAAU;AACV,aAAS;AACT,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,UAAQ,GAAG,UAAU,QAAQ;AAC7B,UAAQ,GAAG,WAAW,QAAQ;AAG9B,MAAI,WAAW,MAAM,UAAU,GAAG;AAChC,eAAW,MAAM,UAAU;AAAA,EAC7B;AAEA,MAAI,iBAAiB;AAErB,SAAO,SAAS;AACd;AACA,WAAO,KAAK,kBAAkB,cAAc,MAAM;AAElD,QAAI;AACF,YAAM,aAAa,YAAY,cAAc;AAAA,IAC/C,SAAS,OAAO;AACd,aAAO,MAAM,mBAAmB,KAAK;AACrC,cAAQ,MAAM,cAAc,cAAc,YAAa,MAAgB,OAAO,EAAE;AAAA,IAClF;AAGA,QAAI,WAAW,GAAG;AAChB,aAAO,KAAK,uBAAuB;AACnC;AAAA,IACF;AAGA,UAAM,SAAS,KAAK,MAAM,KAAK,OAAO,IAAI,aAAa,GAAG;AAC1D,UAAM,UAAU,aAAa;AAC7B,WAAO,KAAK,YAAY,KAAK,MAAM,UAAU,GAAI,CAAC,2BAA2B;AAG7E,UAAM,UAAU;AAChB,QAAI,QAAQ;AACZ,WAAO,QAAQ,WAAW,SAAS;AACjC,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,KAAK,IAAI,SAAS,UAAU,KAAK,CAAC,CAAC;AAC1E,eAAS;AACT,UAAI,WAAW,GAAG;AAChB,kBAAU;AACV;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,WAAS;AACT,SAAO,KAAK,sBAAsB;AAClC,UAAQ,IAAI,wBAAwB;AACtC;AAEA,eAAe,aAAa,YAAoB,gBAAuC;AAErF,SAAO,KAAK,mBAAmB;AAC/B,MAAI;AACF,UAAM,UAAU,MAAM,WAAW;AACjC,QAAI,QAAQ,SAAS,GAAG;AACtB,aAAO,KAAK,WAAW,QAAQ,MAAM,gBAAgB;AAAA,IACvD;AAAA,EACF,SAAS,OAAO;AACd,WAAO,KAAK,uBAAwB,MAAgB,OAAO,EAAE;AAAA,EAC/D;AAGA,QAAM,QAAQ,MAAM,iBAAiB,UAAU;AAC/C,SAAO,KAAK,YAAY,MAAM,SAAS,MAAM,uBAAuB,MAAM,SAAS,MAAM,YAAY;AAErG,MAAI,MAAM,QAAQ,WAAW,GAAG;AAC9B,WAAO,KAAK,uCAAuC;AACnD;AAAA,EACF;AAEA,SAAO,KAAK,YAAY,MAAM,QAAQ,MAAM,aAAa;AAGzD,aAAW,UAAU,MAAM,SAAS;AAClC,QAAI,OAAO,SAAS;AAClB,aAAO,KAAK,UAAU,OAAO,MAAM,GAAG,OAAO,SAAS,KAAK,OAAO,MAAM,KAAK,EAAE,EAAE;AAAA,IACnF,OAAO;AACL,aAAO,KAAK,YAAY,OAAO,MAAM,KAAK,OAAO,KAAK,EAAE;AAAA,IAC1D;AAAA,EACF;AAEA,aAAW,QAAQ,MAAM,gBAAgB;AACvC,WAAO,KAAK,cAAc,IAAI,EAAE;AAAA,EAClC;AAEA,QAAM,UAAU,sBAAsB;AAAA,IACpC,eAAe,MAAM,SAAS;AAAA,IAC9B,eAAe,MAAM,SAAS;AAAA,IAC9B,SAAS,MAAM;AAAA,IACf,SAAS,MAAM;AAAA,IACf,qBAAqB,MAAM,eAAe;AAAA,EAC5C,CAAC;AACD,SAAO;AAAA,IACL,6BAA6B,QAAQ,iBAAiB,QAAQ,CAAC,CAAC,wBAAwB,QAAQ,mBAAmB,QAAQ,CAAC,CAAC;AAAA,EAC/H;AAEA,SAAO,KAAK,uBAAuB,MAAM,QAAQ,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,MAAM,QAAQ,MAAM,qBAAqB;AAG7H,MAAI,iBAAiB,MAAM,GAAG;AAC5B,QAAI;AACF,aAAO,KAAK,6BAA6B;AACzC,YAAM,mBAAmB,sBAAsB,MAAM,OAAO;AAC5D,YAAM,qBAAqB,MAAM;AAAA,QAC/B,WAAW,aAAa,EAAE,IAAI;AAAA,QAC9B;AAAA,MACF;AAEA,YAAM,YAAY,mBAAmB,QAAQ,MAAM,aAAa;AAChE,UAAI,WAAW;AACb,YAAI;AACF,gBAAM,aAAa,KAAK,MAAM,UAAU,CAAC,CAAC;AAC1C,cAAI,WAAW,YAAY,WAAW,aAAa,QAAQ;AACzD,wBAAY,WAAW,UAAU,cAAc,CAAC,aAAa,aAAa,CAAC;AAC3E,mBAAO,KAAK,wBAAwB,WAAW,QAAQ,EAAE;AAAA,UAC3D;AACA,cAAI,WAAW,kBAAkB,WAAW,mBAAmB,QAAQ;AACrE,kBAAM,WAAW,aAAa;AAC9B,qBAAS,YAAY,KAAK;AAAA,cACxB,aAAa,WAAW;AAAA,cACxB,QAAQ;AAAA,YACV,CAAC;AACD,qBAAS,eAAc,oBAAI,KAAK,GAAE,YAAY;AAC9C,yBAAa,QAAQ;AACrB,mBAAO,KAAK,oBAAoB,WAAW,cAAc,EAAE;AAAA,UAC7D;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,aAAO,KAAK,sBAAuB,IAAc,OAAO,EAAE;AAAA,IAC5D;AAAA,EACF;AACF;","names":[]}

package/dist/{init-ISSXETHY.js → init-2REECUVH.js}

@@ -8,8 +8,8 @@ import {
 import {
   getDefaultModel,
   setLLMApiKey
-} from "./chunk-KWWAIS3C.js";
-import "./chunk-NPV3OV2K.js";
+} from "./chunk-SUZUJGGW.js";
+import "./chunk-YMGJQRKG.js";
 import {
   createDefaultConfig,
   saveConfig
@@ -196,7 +196,7 @@ async function loginFlow() {
   console.log(chalk.green("\u2713 Logged in!\n"));
   console.log(chalk.gray("Opening chat interface...\n"));
   try {
-    const { startWebChat } = await import("./web-chat-3HM35XM4.js");
+    const { startWebChat } = await import("./web-chat-O24HGJVE.js");
     await startWebChat();
   } catch (error) {
     console.log(chalk.yellow(`Could not start chat interface: ${error.message}
@@ -288,7 +288,7 @@ async function showDoneAndOpenChat() {
   console.log(chalk.bold.cyan("\u2501\u2501\u2501 Your Spore is Ready! \u2501\u2501\u2501\n"));
   console.log(chalk.gray("Opening chat interface...\n"));
   try {
-    const { startWebChat } = await import("./web-chat-3HM35XM4.js");
+    const { startWebChat } = await import("./web-chat-O24HGJVE.js");
     await startWebChat();
   } catch (error) {
     console.log(chalk.yellow(`Could not start chat interface: ${error.message}
@@ -413,4 +413,4 @@ async function runInit(token) {
 export {
   runInit
 };
-//# sourceMappingURL=init-ISSXETHY.js.map
+//# sourceMappingURL=init-2REECUVH.js.map

package/dist/{llm-T33QTPVW.js → llm-OGOYCWBH.js}

@@ -6,8 +6,8 @@ import {
   hasLLMKey,
   listLLMKeyStatus,
   setLLMApiKey
-} from "./chunk-KWWAIS3C.js";
-import "./chunk-NPV3OV2K.js";
+} from "./chunk-SUZUJGGW.js";
+import "./chunk-YMGJQRKG.js";
 import "./chunk-NO3NQN67.js";
 import "./chunk-3RYCUGXE.js";
 export {
@@ -19,4 +19,4 @@ export {
   listLLMKeyStatus,
   setLLMApiKey
 };
-//# sourceMappingURL=llm-T33QTPVW.js.map
+//# sourceMappingURL=llm-OGOYCWBH.js.map

package/dist/mcp-server.js

@@ -10,7 +10,7 @@ import {
 import {
   logger,
   setLogLevel
-} from "./chunk-NPV3OV2K.js";
+} from "./chunk-YMGJQRKG.js";
 import {
   loadConfig
 } from "./chunk-NO3NQN67.js";
@@ -388,7 +388,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     },
     async ({ content }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.postTweet(content);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -406,7 +406,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     },
     async ({ tweetId, content }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.replyToTweet(tweetId, content);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -421,7 +421,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     { tweetId: z.string().describe("The ID of the tweet to like") },
     async ({ tweetId }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.likeTweet(tweetId);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -436,7 +436,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     { tweetId: z.string().describe("The ID of the tweet to retweet") },
     async ({ tweetId }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.retweet(tweetId);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -451,7 +451,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     { userId: z.string().describe("The user ID or handle to follow") },
     async ({ userId }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.followUser(userId);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -466,7 +466,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     { userId: z.string().describe("The user ID or handle to unfollow") },
     async ({ userId }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.unfollowUser(userId);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -481,7 +481,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     { count: z.number().optional().describe("Number of tweets to fetch (default 20)") },
     async ({ count }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.getTimeline({ count: count ?? 20 });
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -496,7 +496,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     { count: z.number().optional().describe("Number of mentions to fetch (default 20)") },
     async ({ count }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.getMentions({ count: count ?? 20 });
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -514,7 +514,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     },
     async ({ query, count }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.searchTweets(query, { count: count ?? 20 });
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -529,7 +529,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     { handle: z.string().describe("X handle (without @)") },
     async ({ handle }) => {
       try {
-        const { getXClient } = await import("./x-client-GY6XSPK6.js");
+        const { getXClient } = await import("./x-client-ASXVQ6EV.js");
         const client = await getXClient();
         const result = await client.getProfile(handle);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -547,7 +547,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     },
     async ({ content, scheduledFor }) => {
       try {
-        const { addToQueue } = await import("./queue-G5PTE6R6.js");
+        const { addToQueue } = await import("./queue-D3MRKABU.js");
         const entry = addToQueue(content, scheduledFor);
         return {
           content: [
@@ -565,7 +565,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     {},
     async () => {
       try {
-        const { flushQueue } = await import("./queue-G5PTE6R6.js");
+        const { flushQueue } = await import("./queue-D3MRKABU.js");
         const results = await flushQueue();
         return {
           content: [
@@ -586,7 +586,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     { message: z.string().optional().describe("Optional message to post to the Colony community") },
     async ({ message }) => {
       try {
-        const { colonyCheckin } = await import("./colony-JPZC3R34.js");
+        const { colonyCheckin } = await import("./colony-IVYR233C.js");
         const result = await colonyCheckin(message);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
       } catch (error) {
@@ -600,7 +600,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     {},
     async () => {
       try {
-        const { getColonyMemory } = await import("./colony-JPZC3R34.js");
+        const { getColonyMemory } = await import("./colony-IVYR233C.js");
         const memory = getColonyMemory();
         return { content: [{ type: "text", text: JSON.stringify(memory, null, 2) }] };
       } catch (error) {
@@ -614,7 +614,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     {},
     async () => {
       try {
-        const { getActivePlans } = await import("./colony-JPZC3R34.js");
+        const { getActivePlans } = await import("./colony-IVYR233C.js");
         const plans = getActivePlans();
         return {
           content: [
@@ -637,7 +637,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     },
     async ({ description }) => {
       try {
-        const { proposePlan } = await import("./colony-JPZC3R34.js");
+        const { proposePlan } = await import("./colony-IVYR233C.js");
         const result = await proposePlan(description);
         if (result.success) {
           return {
@@ -660,7 +660,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     },
     async ({ planId }) => {
       try {
-        const { joinPlan } = await import("./colony-JPZC3R34.js");
+        const { joinPlan } = await import("./colony-IVYR233C.js");
         const result = await joinPlan(planId);
         if (result.success) {
           return { content: [{ type: "text", text: "Joined the plan! Go execute it." }] };
@@ -679,7 +679,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     },
     async ({ status }) => {
       try {
-        const { postStatus } = await import("./colony-JPZC3R34.js");
+        const { postStatus } = await import("./colony-IVYR233C.js");
         const result = await postStatus(status);
         if (result.success) {
           return { content: [{ type: "text", text: "Status posted to the Colony." }] };
@@ -696,7 +696,7 @@ Identity saved. Your Spore is alive. Use spora_get_identity to read the full doc
     {},
     async () => {
       try {
-        const { getTodaysActivity } = await import("./colony-JPZC3R34.js");
+        const { getTodaysActivity } = await import("./colony-IVYR233C.js");
         const activity = getTodaysActivity();
         return {
           content: [

package/dist/{prompt-builder-5NYONN2W.js → prompt-builder-KJKFCGM7.js}

@@ -1,23 +1,25 @@
 import {
   buildChatPrompt,
   buildHeartbeatUserMessage,
+  buildReflectionPrompt,
   buildSystemPrompt,
   buildToolDecisionMessage,
   buildTrainingChatPrompt
-} from "./chunk-AOQ3WLZV.js";
+} from "./chunk-Q3YXJ2C6.js";
 import "./chunk-P6KZIJYL.js";
 import "./chunk-WN35MRMF.js";
-import "./chunk-LXQNVVIY.js";
+import "./chunk-4LNMA56H.js";
 import "./chunk-M6YOQVSI.js";
-import "./chunk-NPV3OV2K.js";
+import "./chunk-YMGJQRKG.js";
 import "./chunk-NO3NQN67.js";
 import "./chunk-JBYZ7K56.js";
 import "./chunk-3RYCUGXE.js";
 export {
   buildChatPrompt,
   buildHeartbeatUserMessage,
+  buildReflectionPrompt,
   buildSystemPrompt,
   buildToolDecisionMessage,
   buildTrainingChatPrompt
 };
-//# sourceMappingURL=prompt-builder-5NYONN2W.js.map
+//# sourceMappingURL=prompt-builder-KJKFCGM7.js.map

package/dist/{queue-G5PTE6R6.js → queue-D3MRKABU.js}

@@ -2,8 +2,8 @@ import {
   addToQueue,
   flushQueue,
   showQueue
-} from "./chunk-OACD3HGE.js";
-import "./chunk-NPV3OV2K.js";
+} from "./chunk-7OOGNZBU.js";
+import "./chunk-YMGJQRKG.js";
 import "./chunk-NO3NQN67.js";
 import "./chunk-3RYCUGXE.js";
 export {
@@ -11,4 +11,4 @@ export {
   flushQueue,
   showQueue
 };
-//# sourceMappingURL=queue-G5PTE6R6.js.map
+//# sourceMappingURL=queue-D3MRKABU.js.map

package/dist/{web-chat-3HM35XM4.js → web-chat-O24HGJVE.js}

@@ -303,8 +303,12 @@ async function logChatInteraction(userMessage, agentResponse) {
 }
 async function runNarratedHeartbeat(server) {
   const { loadConfig } = await import("./config-FL4VJVKZ.js");
-  const { flushQueue } = await import("./queue-G5PTE6R6.js");
-  const { runAutonomyCycle } = await import("./autonomy-DAV7X6QS.js");
+  const { flushQueue } = await import("./queue-D3MRKABU.js");
+  const { runAutonomyCycle } = await import("./autonomy-6UWPXTPD.js");
+  const { buildReflectionPrompt } = await import("./prompt-builder-KJKFCGM7.js");
+  const { generateResponse } = await import("./llm-OGOYCWBH.js");
+  const { addLearning } = await import("./memory-OIAH33G2.js");
+  const { loadStrategy, saveStrategy } = await import("./strategy-Z4JSFHSP.js");
   const config = loadConfig();
   const intervalMs = config.runtime?.heartbeatIntervalMs ?? 3e5;
   const maxActions = config.runtime?.actionsPerHeartbeat ?? 4;
@@ -372,6 +376,41 @@ async function runNarratedHeartbeat(server) {
       for (const feedback of cycle.policyFeedback) {
         server.pushAgentEvent("narration", `Policy adjusted plan: ${feedback}`);
       }
+      if (heartbeatCount % 3 === 0) {
+        try {
+          server.pushAgentEvent("narration", "Reflecting on recent performance...");
+          const reflectionPrompt = buildReflectionPrompt(cycle.results);
+          const reflectionResponse = await generateResponse(
+            `You are ${loadIdentity().name}. Reflect honestly on your performance.`,
+            reflectionPrompt
+          );
+          const jsonMatch = reflectionResponse.content.match(/\{[\s\S]*\}/);
+          if (jsonMatch) {
+            try {
+              const reflection = JSON.parse(jsonMatch[0]);
+              if (reflection.learning && reflection.learning !== "null") {
+                addLearning(reflection.learning, "reflection", ["heartbeat", "performance"]);
+                server.pushAgentEvent("narration", `Learned: ${reflection.learning}`);
+                console.log(chalk.dim(`  [Agent] Reflection learning: ${reflection.learning}`));
+              }
+              if (reflection.strategyUpdate && reflection.strategyUpdate !== "null") {
+                const strategy = loadStrategy();
+                strategy.experiments.push({
+                  description: reflection.strategyUpdate,
+                  status: "pending"
+                });
+                strategy.lastUpdated = (/* @__PURE__ */ new Date()).toISOString();
+                saveStrategy(strategy);
+                server.pushAgentEvent("narration", `Strategy: ${reflection.strategyUpdate}`);
+                console.log(chalk.dim(`  [Agent] Strategy update: ${reflection.strategyUpdate}`));
+              }
+            } catch {
+            }
+          }
+        } catch (err) {
+          console.log(chalk.dim(`  [Agent] Reflection failed: ${err.message}`));
+        }
+      }
     } catch (error) {
       const msg = error.message;
       console.error(chalk.red(`  [Agent] Heartbeat #${heartbeatCount} error: ${msg}`));
@@ -394,11 +433,11 @@ async function startWebChat() {
   server.setMessageHandler(async (message) => {
     try {
       if (!systemPrompt || messageCount % 10 === 0) {
-        const { buildTrainingChatPrompt } = await import("./prompt-builder-5NYONN2W.js");
+        const { buildTrainingChatPrompt } = await import("./prompt-builder-KJKFCGM7.js");
         systemPrompt = buildTrainingChatPrompt();
       }
       messageCount++;
-      const { hasLLMKey, chat: chatLLM } = await import("./llm-T33QTPVW.js");
+      const { hasLLMKey, chat: chatLLM } = await import("./llm-OGOYCWBH.js");
       if (!hasLLMKey()) {
         return "I can't respond right now - no API key configured. Run `spora llm set --provider <provider>` to set one up.";
       }
@@ -424,7 +463,7 @@ async function startWebChat() {
 `));
   openBrowser(url);
   try {
-    const { hasLLMKey } = await import("./llm-T33QTPVW.js");
+    const { hasLLMKey } = await import("./llm-OGOYCWBH.js");
     if (hasLLMKey()) {
       runNarratedHeartbeat(server).catch((err) => {
         console.error(chalk.red(`Heartbeat failed to start: ${err}`));
@@ -477,4 +516,4 @@ export {
   openBrowser,
   startWebChat
 };
-//# sourceMappingURL=web-chat-3HM35XM4.js.map
+//# sourceMappingURL=web-chat-O24HGJVE.js.map