thepopebot 1.2.76-beta.13 → 1.2.76-beta.15

package/bin/cli.js

@@ -651,6 +651,7 @@ const PROTECTED_PATHS = [
   '.kimi/',
   '.pi/',
   'skills/',
+  'agents/',
   'node_modules/',
 ];
 

package/lib/ai/index.js

@@ -136,6 +136,9 @@ async function* chatStream(threadId, message, attachments = [], options = {}) {
   const branch = options.branch;
   const codeModeType = options.codeModeType || 'plan';
 
+  // Resolve workspace — for existing chats, read scope from DB (client may not resend it after refresh)
+  let resolvedScope = options.scope || null;
+
   if (!existingChat) {
     // Create workspace if not already provided
     if (!workspaceId) {
@@ -143,7 +146,7 @@ async function* chatStream(threadId, message, attachments = [], options = {}) {
       const workspace = createCodeWorkspace(options.userId || 'unknown', {
         repo: repo,
         branch: branch,
-        scope: options.scope || null,
+        scope: resolvedScope,
       });
       workspaceId = workspace.id;
       const { generateRandomName } = await import('../utils/random-name.js');
@@ -155,6 +158,12 @@ async function* chatStream(threadId, message, attachments = [], options = {}) {
     linkChatToWorkspace(threadId, workspaceId);
   } else {
     workspaceId = workspaceId || existingChat.codeWorkspaceId;
+    // Read scope from workspace record — client may not resend after page refresh
+    if (!resolvedScope && workspaceId) {
+      const { getCodeWorkspaceById } = await import('../db/code-workspaces.js');
+      const ws = getCodeWorkspaceById(workspaceId);
+      if (ws?.scope) resolvedScope = ws.scope;
+    }
   }
 
   // ── SDK path: direct in-process SDK call (no LangGraph, no Docker) ──
@@ -205,7 +214,7 @@ async function* chatStream(threadId, message, attachments = [], options = {}) {
     }
 
     // 2. Resolve scope (working directory + skills)
-    const scope = options.scope || null;
+    const scope = resolvedScope;
     const chatMode = isCodeMode ? 'code' : 'agent';
     const { workingDir, skillsDir } = resolveAgentScope(repoDir, scope);
 
@@ -335,7 +344,7 @@ async function* chatStream(threadId, message, attachments = [], options = {}) {
   try {
     const stream = await agent.stream(
       { messages: [new HumanMessage({ content: messageContent })] },
-      { configurable: { thread_id: threadId, workspaceId, repo, branch, codeModeType, scope: options.scope || null, streamCallback }, streamMode: 'messages' }
+      { configurable: { thread_id: threadId, workspaceId, repo, branch, codeModeType, scope: resolvedScope, streamCallback }, streamMode: 'messages' }
     );
 
     const toolCallNames = {};

package/lib/llm-providers.js

@@ -17,6 +17,7 @@ export const BUILTIN_PROVIDERS = {
     ],
     models: [
       { id: 'claude-sonnet-4-6', name: 'Claude Sonnet 4.6', default: true },
+      { id: 'claude-opus-4-7', name: 'Claude Opus 4.7' },
       { id: 'claude-opus-4-6', name: 'Claude Opus 4.6' },
       { id: 'claude-haiku-4-5-20251001', name: 'Claude Haiku 4.5' },
       { id: 'claude-sonnet-4-20250514', name: 'Claude Sonnet 4' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thepopebot",
-  "version": "1.2.76-beta.13",
+  "version": "1.2.76-beta.15",
   "type": "module",
   "description": "Create autonomous AI agents with a two-layer architecture: Next.js Event Handler + Docker Agent.",
   "bin": {

package/setup/lib/providers.mjs

@@ -14,7 +14,8 @@ export const PROVIDERS = {
     builtin: true,
     oauthSupported: true,
     models: [
-      { id: 'claude-opus-4-6', name: 'Claude Opus 4.6', default: true },
+      { id: 'claude-opus-4-7', name: 'Claude Opus 4.7', default: true },
+      { id: 'claude-opus-4-6', name: 'Claude Opus 4.6' },
       { id: 'claude-sonnet-4-6', name: 'Claude Sonnet 4.6' },
       { id: 'claude-haiku-4-5-20251001', name: 'Claude Haiku 4.5' },
     ],

package/templates/agent-job/CLAUDE.md.template

@@ -26,7 +26,9 @@ There are three action types:
 }
 ```
 
-Optional: add `"llm_provider"` and `"llm_model"` to override the default LLM for that job.
+Optional fields:
+- `"scope"` (e.g. `"agents/my-agent"`) — routes the cron to a scoped agent. Its `SYSTEM.md`, skills directory, and working directory all switch to that subdirectory. See `agents/CLAUDE.md` for the full pattern.
+- `"llm_provider"` and `"llm_model"` — override the default LLM for that job.
 
 **`command`** — Runs a shell command on the event handler (working directory: project root).
 

package/templates/agent-job/SYSTEM.md

@@ -7,11 +7,9 @@ You are an autonomous AI agent running inside a Docker container on thepopebot.
 Your workspace is `/home/coding-agent/workspace` — a live git repository.
 
 ## Temporary Files
-Use `/home/coding-agent/workspace/.tmp/` for working files — downloads, screenshots, intermediate data, scripts, generated files. `/home/coding-agent/workspace/.tmp/` is gitignored and nothing there gets committed. If a tool downloads a file, save it to `/home/coding-agent/workspace/.tmp/` and reference it directly.
+Use `/tmp` for working files — downloads, screenshots, intermediate data, scripts, generated files. If a tool downloads a file, save it to `/tmp` and reference it directly.
 
-**DO NOT USE** `/tmp` because that will leak and waste disk space from writing extra layers to the container.
-
-Everything in the workspace is automatically committed and pushed when your job finishes. You do not control this. Be intentional about what you put here — **any file you create, move, or download into the workspace WILL be committed.**
+Everything in the workspace `/home/coding-agent/workspace` is automatically committed and pushed when your job finishes. You do not control this. Be intentional about what you put here — **any file you create, move, or download into the workspace WILL be committed.**
 
 ## Directory Layout
 

package/templates/agents/CLAUDE.md.template

@@ -12,6 +12,8 @@ agents/
 
 `SYSTEM.md` is the agent's system prompt. Write it in markdown addressed to the agent (e.g. "You are a code reviewer...").
 
+> **Important:** `agents/<name>/SYSTEM.md` **replaces** `agent-job/SYSTEM.md` when the agent is scoped — it doesn't extend it. Use `agent-job/SYSTEM.md` as a starting template and adapt it: keep the runtime environment notes, the `/tmp` scratch directive, and add the `{{skills}}` token if you want skill descriptions injected. Then add the agent's identity-specific instructions on top.
+
 For agents with multiple complex tasks, add a `jobs/` subfolder:
 
 ```
@@ -25,29 +27,22 @@ agents/
 
 ## Scheduling
 
-Add a cron entry in `agent-job/CRONS.json`:
+Add a cron entry in `agent-job/CRONS.json` with a `scope` field pointing at the agent:
 
 ```json
 {
-  "name": "my-agent-daily",
-  "schedule": "0 9 * * *",
+  "name": "my-agent-weekly-report",
+  "schedule": "0 9 * * 1",
   "type": "agent",
-  "job": "Read agents/my-agent/SYSTEM.md and follow the instructions there.",
+  "scope": "agents/my-agent",
+  "job": "Follow the instructions in jobs/weekly-report.md",
   "enabled": true
 }
 ```
 
-For job-specific prompts, chain the reads:
+`scope` activates the agent's identity (`SYSTEM.md`), skills, and working directory — the cron runs as the scoped agent, not from the repo root. `job` is the task prompt the agent receives.
 
-```json
-{
-  "name": "my-agent-report",
-  "schedule": "0 9 * * 1",
-  "type": "agent",
-  "job": "Read agents/my-agent/SYSTEM.md for context, then read agents/my-agent/prompts/weekly-report.md and complete that task.",
-  "enabled": true
-}
-```
+For reusable tasks, write the prompt as markdown in `agents/<name>/jobs/<task>.md` and reference it from `job` — the agent's working directory is the scoped folder, so the relative path resolves. For one-off tasks, write the prompt inline.
 
 ## Removing an Agent
 

package/templates/docker-compose.custom.yml

@@ -46,6 +46,7 @@ services:
     volumes:
       - .:/project
       - ./agent-job:/app/agent-job
+      - ./agents:/app/agents
       - ./event-handler:/app/event-handler
       - ./skills:/app/skills
       - ./.env:/app/.env