@agentprojectcontext/apx 1.10.2 → 1.10.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentprojectcontext/apx",
-  "version": "1.10.2",
+  "version": "1.10.3",
   "description": "APX — unified CLI + daemon for the Agent Project Context (APC) standard.",
   "publishConfig": {
     "access": "public"

package/src/cli/commands/session.js

@@ -3,7 +3,7 @@ import path from "node:path";
 import { findApfRoot, readAgents } from "../../core/parser.js";
 import { getOrCreateApxId } from "../../core/scaffold.js";
 import { generateSessionId } from "../../core/session-store.js";
-import { ensureProjectStorage } from "../../core/config.js";
+import { projectStorageRoot, ensureProjectStorage } from "../../core/config.js";
 import { http } from "../http.js";
 import { resolveProjectId } from "./project.js";
 
@@ -18,7 +18,7 @@ function requireRoot() {
 function requireStorageRoot(root) {
   const apxId = getOrCreateApxId(root);
   if (!apxId) throw new Error("could not resolve APX project storage id");
-  return ensureProjectStorage(apxId);
+  return projectStorageRoot(apxId);
 }
 
 const nowIso = () => new Date().toISOString().replace(/\.\d{3}Z$/, "Z");

package/src/core/scaffold.js

@@ -256,6 +256,7 @@ export function getOrCreateApxId(root) {
   try { cfg = JSON.parse(fs.readFileSync(p, "utf8")); } catch { return null; }
   if (cfg.apx_id) return cfg.apx_id;
   const apxId = crypto.randomUUID().replace(/-/g, "").slice(0, 12);
+  console.log(`[apx] Generating new stable ID ${apxId} for project at ${root}`);
   cfg.apx_id = apxId;
   fs.writeFileSync(p, JSON.stringify(cfg, null, 2) + "\n");
   return apxId;

package/src/daemon/db.js

@@ -37,9 +37,11 @@ export class ProjectManager {
     // Ensure directories exist for projects initialized before they were added.
     fs.mkdirSync(path.join(abs, ".apc", "commands"), { recursive: true });
 
-    // Ensure stable APX storage root exists (~/.apx/projects/<apx_id>/).
+    // Resolve stable APX storage ID (read from .apc/project.json).
     const apxId = getOrCreateApxId(abs);
-    const storagePath = ensureProjectStorage(apxId);
+    // Don't create the physical storage folder yet.
+    // Just resolve where it SHOULD be.
+    const storagePath = path.join(path.dirname(DEFAULT_PROJECT_STORE), apxId || "null");
 
     const entry = {
       id: this._nextId++,
@@ -48,8 +50,15 @@ export class ProjectManager {
       apxId,
       config: effectiveConfig(this.globalConfig, abs),
     };
-    // Project runtime messages stay in APX local storage.
-    entry.logMessage = (payload) => appendMessageToFs({ projectRoot: storagePath, ...payload });
+
+    // Lazy message logger: ensure directory exists ONLY when writing.
+    entry.logMessage = (payload) => {
+      if (entry.apxId) {
+        ensureProjectStorage(entry.apxId);
+      }
+      return appendMessageToFs({ projectRoot: entry.storagePath, ...payload });
+    };
+
     this.byId.set(entry.id, entry);
     this.byPath.set(abs, entry);
     return entry;

package/src/daemon/super-agent-tools/tools/call-runtime.js

@@ -99,7 +99,7 @@ export default {
         type: "object",
         properties: {
           project: { type: "string" },
-          agent: { type: "string", description: "Optional APC agent slug from AGENTS.md, not runtime name. Use only when the user explicitly named that agent. Omit for 'vos mismo', 'default', 'base', or no agent." },
+          agent: { type: "string", description: "APC agent slug. MANDATORY OMIT if you are acting as yourself (APX/vos mismo/default). Use ONLY if the user named a specific agent from AGENTS.md." },
           runtime: {
             type: "string",
             enum: RUNTIME_IDS,

package/src/daemon/super-agent.js

@@ -53,11 +53,11 @@ HARD RULES (do not deviate):
 7. Stay brief: under 6 sentences unless asked for detail.
 8. You DO see recent prior turns of this chat as previous messages when applicable. **Use them ONLY to disambiguate references** (e.g. "el primero" → first project mentioned earlier). For ANY factual data — agent details, MCP details, file contents, memory — RE-CALL the tool. Past turns are context, not a cache. Models change, agents change, files change.
 9. /reset or /new from the user means "forget previous turns and answer this one fresh" — if you see those prefixes the operator already cleared the context for you.
-10. SELF-RUN RULE: if the user says "vos mismo", "tu mismo", "same", "base", "default", "sin agente", or does not explicitly name an agent slug, act as APX itself. Do NOT call list_agents to choose a candidate. Do NOT pass agent to call_runtime/call_agent.
-11. DELEGATION RULE: when the user asks a named APC agent to do a task, use call_agent (unless they specify opening it in a runtime, then see rule 12).
-12. DISPATCH RULE: when the user asks to work inside Claude, Codex, OpenCode, Aider, Cursor, Gemini CLI, or Qwen Code, use call_runtime({runtime: 'claude-code'|'codex'|'opencode'|'aider'|'cursor-agent'|'gemini-cli'|'qwen-code', prompt: <user's request>}). First prefer runtimes the tool reports as installed/runnable; if a runtime is missing or fails, report that fact and its stderr/error instead of pretending success. If the user explicitly named an agent slug, pass agent: <slug>. If they didn't, DO NOT pass agent. When an agent is passed, its memory + skills become the system prompt of the runtime.
-13. PROJECT RULE: when the user gives no project, use project "default". Do not infer a non-default project from old chat history unless the user references it. If they mention a path or project name, look it up or add it with add_project.
-14. VAULT RULE: when the user wants a new existing agent/template, call list_vault_agents first. If a suitable vault agent exists, import_agent into the chosen project. If none fits, say briefly what is missing.
+10. **SELF-RUN RULE**: If the user says "vos mismo", "tu mismo", "same", "base", "default", "sin agente", or does not explicitly name an agent slug, act as APX. **DO NOT** call list_agents. **DO NOT** pass an 'agent' argument to tools.
+11. DELEGATION RULE: When the user asks a named APC agent to do a task, use call_agent (unless they specify opening it in a runtime, then see rule 12).
+12. **DISPATCH RULE**: Use call_runtime for external runtimes. If the user named an agent, pass it. If they didn't, **DO NOT PASS ANY AGENT**. Running with an empty agent field is how you run as yourself.
+13. PROJECT RULE: When the user gives no project, use project "default". Do not infer a non-default project from old chat history unless the user references it. If they mention a path or project name, look it up or add it with add_project.
+14. VAULT RULE: When the user wants a new existing agent/template, call list_vault_agents first. If a suitable vault agent exists, import_agent into the chosen project. If none fits, say briefly what is missing.
 15. NO-PENDING RULE: never say "give me a second", "I will do it", or "I will try later" as a final answer. Either call the tool in this same turn or say what blocks you.
 16. IDENTITY RULE: when the user asks you to change your name, call yourself something, or update your personality/language, call set_identity and persist the change. Then confirm with your new name.
 17. ROUTINES RULE: NEVER create a routine in the default project (id=0). Routines MUST be tied to a specific registered project. Before adding a routine, call list_projects to find the correct project id or name. Then pass --project <id|name> to apx routine add. If no project fits, ask the user which project to use. Creating routines in project 0/default mixes unrelated projects' schedules and corrupts state.`;