@agentprojectcontext/apx 1.0.3 → 1.2.0

package/src/daemon/api.js

@@ -1,4 +1,4 @@
-// Express REST API for APX. See docs/APX-DAEMON.md §4.
+// Express REST API for APX. See APC docs reference/apx-daemon.
 import fs from "node:fs";
 import path from "node:path";
 import express from "express";
@@ -175,7 +175,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
     const agents = readAgents(p.path);
     if (!agents.find((a) => a.slug === req.params.slug))
       return res.status(404).json({ error: "agent not found" });
-    const sessionsDir = path.join(p.path, ".apc", "agents", req.params.slug, "sessions");
+    const sessionsDir = path.join(p.storagePath, "agents", req.params.slug, "sessions");
     if (!fs.existsSync(sessionsDir)) return res.json([]);
     const sessions = fs
       .readdirSync(sessionsDir)
@@ -201,7 +201,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
     if (!p) return;
     const { title, body = "" } = req.body || {};
     if (!title) return res.status(400).json({ error: "title required" });
-    const sessionsDir = path.join(p.path, ".apc", "agents", req.params.slug, "sessions");
+    const sessionsDir = path.join(p.storagePath, "agents", req.params.slug, "sessions");
     fs.mkdirSync(sessionsDir, { recursive: true });
     const titleSlug =
       title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "session";
@@ -225,7 +225,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
     if (!p) return;
     const sid = req.params.sid;
     const filename = sid.endsWith(".md") ? sid : `${sid}.md`;
-    const agentsDir = path.join(p.path, ".apc", "agents");
+    const agentsDir = path.join(p.storagePath, "agents");
     let found = null;
     if (fs.existsSync(agentsDir)) {
       for (const slug of fs.readdirSync(agentsDir)) {
@@ -335,7 +335,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
     const p = project(req, res);
     if (!p) return;
     const { agent, channel, since, limit = "100" } = req.query;
-    const rows = readProjectMessages(p.path, {
+    const rows = readProjectMessages(p.storagePath, {
       channel: channel || undefined,
       agent_slug: agent || undefined,
       since: since || undefined,
@@ -362,7 +362,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
     if (!p) return;
     const { q, limit = "50" } = req.query;
     if (!q) return res.status(400).json({ error: "q required" });
-    res.json(searchProjectMessages(p.path, q, Math.min(parseInt(limit, 10) || 50, 500)));
+    res.json(searchProjectMessages(p.storagePath, q, Math.min(parseInt(limit, 10) || 50, 500)));
   });
 
   // ---- Global messages (cross-project channels: telegram, direct, …) ----
@@ -421,7 +421,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
 
     try {
       const system = buildAgentSystem(p, agent);
-      const conv = startConversation({ projectRoot: p.path, agentSlug: agent.slug, engine: modelId, system });
+      const conv = startConversation({ storagePath: p.storagePath, agentSlug: agent.slug, engine: modelId, system });
       appendTurn({ filePath: conv.path, role: "user", content: prompt });
 
       const result = await callEngine({
@@ -470,7 +470,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
       let compactSummary = null;
 
       if (conversation_id) {
-        const existing = readConversation(p.path, agent.slug, conversation_id);
+        const existing = readConversation(p.storagePath, agent.slug, conversation_id);
         if (!existing) return res.status(404).json({ error: `conversation ${conversation_id} not found` });
         convPath = existing.path;
         convId = conversation_id;
@@ -492,7 +492,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
       const system = buildAgentSystem(p, agent, { extraParts });
 
       if (!conversation_id) {
-        const conv = startConversation({ projectRoot: p.path, agentSlug: agent.slug, engine: modelId, system });
+        const conv = startConversation({ storagePath: p.storagePath, agentSlug: agent.slug, engine: modelId, system });
         convPath = conv.path;
         convId = conv.id;
       }
@@ -523,14 +523,14 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
     const agents = readAgents(p.path);
     if (!agents.find((a) => a.slug === req.params.slug))
       return res.status(404).json({ error: "agent not found" });
-    res.json(listConversations(p.path, req.params.slug));
+    res.json(listConversations(p.storagePath, req.params.slug));
   });
 
   // GET /projects/:pid/agents/:slug/conversations/:id
   app.get("/projects/:pid/agents/:slug/conversations/:id", (req, res) => {
     const p = project(req, res);
     if (!p) return;
-    const conv = readConversation(p.path, req.params.slug, req.params.id);
+    const conv = readConversation(p.storagePath, req.params.slug, req.params.id);
     if (!conv) return res.status(404).json({ error: "conversation not found" });
     res.json(conv);
   });
@@ -547,7 +547,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
     if (!modelId) return res.status(400).json({ error: "agent has no model" });
     try {
       const result = await compactConversation({
-        projectRoot: p.path,
+        storagePath: p.storagePath,
         agentSlug: agent.slug,
         filename: filename || null,
         modelId,
@@ -625,7 +625,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
     if (!agents.find((a) => a.slug === req.params.slug))
       return res.status(404).json({ error: "agent not found" });
 
-    const messages = readProjectMessages(p.path, { agent_slug: req.params.slug });
+    const messages = readProjectMessages(p.storagePath, { agent_slug: req.params.slug });
     const peers = new Map();
     for (const m of messages) {
       const peer = m.meta?.from || m.meta?.to || null;
@@ -679,6 +679,7 @@ export function buildApi({ projects, registries, plugins, scheduler, version, st
 
     const session = createRuntimeSession({
       projectRoot: p.path,
+      storageRoot: p.storagePath,
       agentSlug: agent.slug,
       runtime,
       title: req.body?.title,

package/src/daemon/compact.js

@@ -52,8 +52,8 @@ Style: dense and factual. No pleasantries. No meta-commentary. Just the facts.
 
 // Resolve the most-recent conversation file for an agent, or the one explicitly
 // named. Returns the full filepath.
-function resolveConvFile(projectRoot, agentSlug, filename) {
-  const dir = path.join(projectRoot, ".apc", "agents", agentSlug, "conversations");
+function resolveConvFile(storagePath, agentSlug, filename) {
+  const dir = path.join(storagePath, "agents", agentSlug, "conversations");
   if (!fs.existsSync(dir)) throw new Error(`no conversations dir for agent "${agentSlug}"`);
 
   if (filename) {
@@ -76,13 +76,13 @@ function serializeFm(obj) {
 }
 
 export async function compactConversation({
-  projectRoot,
+  storagePath,
   agentSlug,
   filename,
   modelId,
   config,
 }) {
-  const filepath = resolveConvFile(projectRoot, agentSlug, filename);
+  const filepath = resolveConvFile(storagePath, agentSlug, filename);
   const raw = fs.readFileSync(filepath, "utf8");
   const { fm, turns } = parseConversation(raw);
 

package/src/daemon/conversations.js

@@ -1,14 +1,14 @@
-// Conversation storage: append-only markdown at .apc/agents/<slug>/conversations/
-// with SQLite mirror for fast querying. Filesystem is source of truth.
+// Conversation storage: append-only markdown at ~/.apx/projects/<id>/agents/<slug>/conversations/
+// Filesystem is source of truth. storagePath = ~/.apx/projects/<apx_id>
 
 import fs from "node:fs";
 import path from "node:path";
 
 const nowIso = () => new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
 
-export function generateConversationId(projectRoot, agentSlug) {
+export function generateConversationId(storagePath, agentSlug) {
   const today = new Date().toISOString().slice(0, 10);
-  const dir = path.join(projectRoot, ".apc", "agents", agentSlug, "conversations");
+  const dir = path.join(storagePath, "agents", agentSlug, "conversations");
   let next = 1;
   if (fs.existsSync(dir)) {
     for (const f of fs.readdirSync(dir)) {
@@ -22,15 +22,15 @@ export function generateConversationId(projectRoot, agentSlug) {
   return `${today}-${String(next).padStart(2, "0")}`;
 }
 
-export function conversationPath(projectRoot, agentSlug, idOrFilename) {
+export function conversationPath(storagePath, agentSlug, idOrFilename) {
   const filename = idOrFilename.endsWith(".md") ? idOrFilename : `${idOrFilename}.md`;
-  return path.join(projectRoot, ".apc", "agents", agentSlug, "conversations", filename);
+  return path.join(storagePath, "agents", agentSlug, "conversations", filename);
 }
 
-export function startConversation({ projectRoot, agentSlug, engine, system }) {
-  const dir = path.join(projectRoot, ".apc", "agents", agentSlug, "conversations");
+export function startConversation({ storagePath, agentSlug, engine, system }) {
+  const dir = path.join(storagePath, "agents", agentSlug, "conversations");
   fs.mkdirSync(dir, { recursive: true });
-  const id = generateConversationId(projectRoot, agentSlug);
+  const id = generateConversationId(storagePath, agentSlug);
   const file = path.join(dir, `${id}.md`);
   const started = nowIso();
   const fm =
@@ -84,14 +84,14 @@ export function parseConversation(text) {
   return { fm, turns };
 }
 
-export function readConversation(projectRoot, agentSlug, idOrFilename) {
-  const p = conversationPath(projectRoot, agentSlug, idOrFilename);
+export function readConversation(storagePath, agentSlug, idOrFilename) {
+  const p = conversationPath(storagePath, agentSlug, idOrFilename);
   if (!fs.existsSync(p)) return null;
   return { ...parseConversation(fs.readFileSync(p, "utf8")), path: p };
 }
 
-export function listConversations(projectRoot, agentSlug) {
-  const dir = path.join(projectRoot, ".apc", "agents", agentSlug, "conversations");
+export function listConversations(storagePath, agentSlug) {
+  const dir = path.join(storagePath, "agents", agentSlug, "conversations");
   if (!fs.existsSync(dir)) return [];
   return fs
     .readdirSync(dir)

package/src/daemon/db.js

@@ -5,6 +5,12 @@ import path from "node:path";
 import { appendMessageToFs } from "../core/messages-store.js";
 import { effectiveConfig } from "./project-config.js";
 import { readAgents } from "../core/parser.js";
+import { getOrCreateApxId } from "../core/scaffold.js";
+import {
+  ensureProjectStorage,
+  DEFAULT_PROJECT_ID,
+  DEFAULT_PROJECT_STORE,
+} from "../core/config.js";
 
 export class ProjectManager {
   constructor(globalConfig = {}) {
@@ -30,19 +36,56 @@ export class ProjectManager {
     }
     // Ensure directories exist for projects initialized before they were added.
     fs.mkdirSync(path.join(abs, ".apc", "commands"), { recursive: true });
-    fs.mkdirSync(path.join(abs, ".apc", "messages"), { recursive: true });
+
+    // Ensure stable APX storage root exists (~/.apx/projects/<apx_id>/).
+    const apxId = getOrCreateApxId(abs);
+    const storagePath = ensureProjectStorage(apxId);
 
     const entry = {
       id: this._nextId++,
       path: abs,
+      storagePath,
+      apxId,
       config: effectiveConfig(this.globalConfig, abs),
     };
-    entry.logMessage = (payload) => appendMessageToFs({ projectRoot: abs, ...payload });
+    // Project runtime messages stay in APX local storage.
+    entry.logMessage = (payload) => appendMessageToFs({ projectRoot: storagePath, ...payload });
     this.byId.set(entry.id, entry);
     this.byPath.set(abs, entry);
     return entry;
   }
 
+  // Register the always-available default project (no local .apc/ required).
+  // Called once at daemon startup. Uses id=0.
+  // The default project lives entirely at ~/.apx/projects/default/ and mirrors
+  // the APC structure so that parser functions can read agents/memory from it.
+  registerDefault() {
+    if (this.byId.has(0)) return this.byId.get(0);
+    // Create a minimal APC-compatible structure inside the storage root so that
+    // readAgents() and other parser functions work without a separate project dir.
+    const apcDir = path.join(DEFAULT_PROJECT_STORE, ".apc");
+    fs.mkdirSync(path.join(apcDir, "agents"), { recursive: true });
+    const projectJson = path.join(apcDir, "project.json");
+    if (!fs.existsSync(projectJson)) {
+      fs.writeFileSync(
+        projectJson,
+        JSON.stringify({ name: "default", apx_id: DEFAULT_PROJECT_ID, apx: "installed" }, null, 2) + "\n"
+      );
+    }
+    // The default project uses its storagePath as both the APC root and the storage root.
+    const entry = {
+      id: 0,
+      path: DEFAULT_PROJECT_STORE,
+      storagePath: DEFAULT_PROJECT_STORE,
+      apxId: DEFAULT_PROJECT_ID,
+      config: effectiveConfig(this.globalConfig, DEFAULT_PROJECT_STORE),
+    };
+    entry.logMessage = (payload) => appendMessageToFs({ projectRoot: DEFAULT_PROJECT_STORE, ...payload });
+    this.byId.set(0, entry);
+    this.byPath.set(DEFAULT_PROJECT_STORE, entry);
+    return entry;
+  }
+
   get(id) {
     return this.byId.get(Number(id)) || null;
   }

package/src/daemon/index.js

@@ -79,6 +79,9 @@ async function main() {
   const projects = new ProjectManager(cfg);
   const registries = new RegistryCache();
 
+  // Default project (id=0) is always available — no local .apc/ required.
+  projects.registerDefault();
+
   // Load registered projects from config.
   for (const entry of cfg.projects) {
     try {

package/src/daemon/smoke.js

@@ -33,14 +33,13 @@ assert(agents.length === 2, `expected 2 agents, got ${agents.length}`);
 assert(agents.find((a) => a.slug === "sofia"), "sofia missing");
 assert(agents.find((a) => a.slug === "martin"), "martin missing");
 
-// Sessions: scan .apc/agents/sofia/sessions/
+// Sessions: scan APX local runtime storage.
 const sofiaSessions = (() => {
-  const dir = path.join(entry.path, ".apc", "agents", "sofia", "sessions");
+  const dir = path.join(entry.storagePath, "agents", "sofia", "sessions");
   if (!fs.existsSync(dir)) return [];
   return fs.readdirSync(dir).filter((f) => f.endsWith(".md"));
 })();
 console.log("sofia sessions:", sofiaSessions);
-assert(sofiaSessions.length >= 1, "expected at least one sofia session");
 
 const reg = new McpRegistry(entry.path);
 const list = reg.list();