@hasna/assistants 1.1.4 → 1.1.5

package/dist/cli.js

@@ -162302,6 +162302,48 @@ class AssistantLoop {
     if (this.extraSystemPrompt) {
       this.context.addSystemMessage(this.extraSystemPrompt);
     }
+    if (this.config.heartbeat?.autonomous) {
+      const maxSleepMin = Math.round((this.config.heartbeat.maxSleepMs ?? 1800000) / 60000);
+      this.context.addSystemMessage(`## Autonomous Heartbeat System
+
+You are running in **autonomous mode**. You manage your own wakeup schedule.
+
+### How it works
+- After every turn, a safety-net hook ensures a heartbeat schedule exists
+- The heartbeat fires \`/main-loop\` which runs your autonomous check-in skill
+- A watchdog monitors your health and forces a wakeup if you're overdue
+
+### Your responsibilities at the END of every turn
+1. **Save state** to memory before the turn ends:
+   - \`memory_save agent.heartbeat.intention "what you plan to do next"\`
+   - \`memory_save agent.state.pending "items waiting for follow-up"\`
+   - \`memory_save agent.state.lastActions "what you just did"\`
+2. **Schedule your next heartbeat**:
+   - Delete old: \`schedule_delete heartbeat-${this.sessionId}\`
+   - Create new: \`schedule_create\` with \`kind: "once"\`, \`actionType: "message"\`, \`message: "/main-loop"\`, and \`at\` set to your chosen time
+3. **Save goals** when they change: \`memory_save agent.goals "..."\`
+
+### Timing guidelines
+| Situation | Wake up in |
+|-----------|-----------|
+| Active jobs running or tasks pending | 1\u20133 minutes |
+| Goals exist but nothing urgent | 5\u201315 minutes |
+| Nothing pending, user idle | 15\u2013${maxSleepMin} minutes (max) |
+
+### Key memory keys
+- \`agent.heartbeat.last\` \u2014 when you last ran (save ISO timestamp)
+- \`agent.heartbeat.next\` \u2014 when you plan to run next
+- \`agent.heartbeat.intention\` \u2014 why you're waking up
+- \`agent.goals\` \u2014 your active goals
+- \`agent.state.pending\` \u2014 items waiting
+- \`agent.state.lastActions\` \u2014 what you did recently
+
+### Rules
+- **Stay fast** \u2014 if work takes >30s, delegate to a subassistant
+- **Never sleep longer than ${maxSleepMin} minutes** \u2014 the system enforces this cap
+- **Always schedule your next heartbeat** \u2014 if you forget, the safety net creates a default one
+`);
+    }
     this.contextManager?.refreshState(this.context.getMessages());
     await this.hookExecutor.execute(this.hookLoader.getHooks("SessionStart"), {
       session_id: this.sessionId,

package/dist/lib.js

@@ -155483,6 +155483,48 @@ class AssistantLoop {
     if (this.extraSystemPrompt) {
       this.context.addSystemMessage(this.extraSystemPrompt);
     }
+    if (this.config.heartbeat?.autonomous) {
+      const maxSleepMin = Math.round((this.config.heartbeat.maxSleepMs ?? 1800000) / 60000);
+      this.context.addSystemMessage(`## Autonomous Heartbeat System
+
+You are running in **autonomous mode**. You manage your own wakeup schedule.
+
+### How it works
+- After every turn, a safety-net hook ensures a heartbeat schedule exists
+- The heartbeat fires \`/main-loop\` which runs your autonomous check-in skill
+- A watchdog monitors your health and forces a wakeup if you're overdue
+
+### Your responsibilities at the END of every turn
+1. **Save state** to memory before the turn ends:
+   - \`memory_save agent.heartbeat.intention "what you plan to do next"\`
+   - \`memory_save agent.state.pending "items waiting for follow-up"\`
+   - \`memory_save agent.state.lastActions "what you just did"\`
+2. **Schedule your next heartbeat**:
+   - Delete old: \`schedule_delete heartbeat-${this.sessionId}\`
+   - Create new: \`schedule_create\` with \`kind: "once"\`, \`actionType: "message"\`, \`message: "/main-loop"\`, and \`at\` set to your chosen time
+3. **Save goals** when they change: \`memory_save agent.goals "..."\`
+
+### Timing guidelines
+| Situation | Wake up in |
+|-----------|-----------|
+| Active jobs running or tasks pending | 1\u20133 minutes |
+| Goals exist but nothing urgent | 5\u201315 minutes |
+| Nothing pending, user idle | 15\u2013${maxSleepMin} minutes (max) |
+
+### Key memory keys
+- \`agent.heartbeat.last\` \u2014 when you last ran (save ISO timestamp)
+- \`agent.heartbeat.next\` \u2014 when you plan to run next
+- \`agent.heartbeat.intention\` \u2014 why you're waking up
+- \`agent.goals\` \u2014 your active goals
+- \`agent.state.pending\` \u2014 items waiting
+- \`agent.state.lastActions\` \u2014 what you did recently
+
+### Rules
+- **Stay fast** \u2014 if work takes >30s, delegate to a subassistant
+- **Never sleep longer than ${maxSleepMin} minutes** \u2014 the system enforces this cap
+- **Always schedule your next heartbeat** \u2014 if you forget, the safety net creates a default one
+`);
+    }
     this.contextManager?.refreshState(this.context.getMessages());
     await this.hookExecutor.execute(this.hookLoader.getHooks("SessionStart"), {
       session_id: this.sessionId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/assistants",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "AI assistant that runs in your terminal - powered by Claude",
   "license": "MIT",
   "type": "module",