@agentprojectcontext/apx 1.57.0 → 1.59.0

package/src/core/stores/tasks.js

@@ -19,6 +19,16 @@ import path from "node:path";
 import { nowIso } from "../util/time.js";
 import { shortId as makeShortId } from "../util/ids.js";
 
+// Workflow sub-status for an *open* task. Orthogonal to `state`
+// (open/done/dropped): `state` is the storage lifecycle, `status` is how an
+// open task is progressing. `blocked` means it's waiting on a human/agent.
+export const TASK_STATUSES = Object.freeze(["pending", "running", "in_review", "blocked"]);
+export const DEFAULT_TASK_STATUS = "pending";
+
+function normalizeStatus(v) {
+  return TASK_STATUSES.includes(v) ? v : DEFAULT_TASK_STATUS;
+}
+
 function tasksDir(storagePath) {
   return path.join(storagePath, "tasks");
 }
@@ -72,12 +82,15 @@ function projectState(events) {
           created_at: ev.ts,
           updated_at: ev.ts,
           state: "open",
+          status: normalizeStatus(ev.status),
           title: ev.title || "",
           body: ev.body || null,
           tags: Array.isArray(ev.tags) ? [...ev.tags] : [],
           due: ev.due || null,
           agent: ev.agent || null,
           source: ev.source || null,
+          created_by: ev.created_by || null,
+          thread: ev.thread || null,
           meta: ev.meta && typeof ev.meta === "object" ? { ...ev.meta } : {},
         });
         break;
@@ -87,7 +100,7 @@ function projectState(events) {
         const patch = ev.patch && typeof ev.patch === "object" ? ev.patch : {};
         for (const k of Object.keys(patch)) {
           if (k === "id" || k === "state" || k === "created_at") continue;
-          existing[k] = patch[k];
+          existing[k] = k === "status" ? normalizeStatus(patch[k]) : patch[k];
         }
         existing.updated_at = ev.ts;
         break;
@@ -141,10 +154,13 @@ export function createTask(storagePath, fields) {
     op: "create",
     title: fields.title.trim(),
     body: fields.body || null,
+    status: normalizeStatus(fields.status),
     tags: Array.isArray(fields.tags) ? fields.tags.filter((t) => typeof t === "string") : [],
     due: fields.due || null,
     agent: fields.agent || null,
     source: fields.source || null,
+    created_by: fields.created_by || null,
+    thread: fields.thread || null,
     meta: fields.meta && typeof fields.meta === "object" ? fields.meta : {},
   };
   appendEvent(storagePath, ev);
@@ -207,6 +223,19 @@ export function patchTask(storagePath, idOrPrefix, patch) {
   return getTask(storagePath, existing.id);
 }
 
+/** Set the workflow status (pending/running/in_review/blocked) of an open task. */
+export function setTaskStatus(storagePath, idOrPrefix, status) {
+  const existing = getTask(storagePath, idOrPrefix);
+  if (!existing) return null;
+  appendEvent(storagePath, {
+    id: existing.id,
+    ts: nowIso(),
+    op: "update",
+    patch: { status: normalizeStatus(status) },
+  });
+  return getTask(storagePath, existing.id);
+}
+
 /** Mark done. */
 export function doneTask(storagePath, idOrPrefix, by = null) {
   const existing = getTask(storagePath, idOrPrefix);
@@ -249,11 +278,15 @@ export function reopenTask(storagePath, idOrPrefix) {
 export function countTasks(storagePath) {
   const tasks = [...projectState(readAllEvents(storagePath)).values()];
   const today = new Date().toISOString().slice(0, 10);
+  const open = tasks.filter((t) => t.state === "open");
+  const byStatus = {};
+  for (const s of TASK_STATUSES) byStatus[s] = open.filter((t) => t.status === s).length;
   return {
-    open: tasks.filter((t) => t.state === "open").length,
+    open: open.length,
     done: tasks.filter((t) => t.state === "done").length,
     dropped: tasks.filter((t) => t.state === "dropped").length,
-    overdue: tasks.filter((t) => t.state === "open" && t.due && t.due < today).length,
+    overdue: open.filter((t) => t.due && t.due < today).length,
     total: tasks.length,
+    status: byStatus,
   };
 }

package/src/host/daemon/api/agents.js

@@ -24,6 +24,17 @@ import {
 } from "#core/agent/memory.js";
 import { agentToResponse } from "./shared.js";
 import { normalizeVaultPatch } from "#core/apc/agents-vault.js";
+import { PERMISSION_MODES } from "#core/constants/permissions.js";
+
+// Autonomy mirrors the super-agent permission modes (total/automatico/permiso).
+// An invalid value is dropped rather than persisted so a typo can't silently
+// widen an agent's autonomy.
+const AUTONOMY_VALUES = new Set(Object.values(PERMISSION_MODES));
+function normalizeAutonomy(v) {
+  if (v === undefined) return undefined;
+  if (v === null || v === "") return null;
+  return AUTONOMY_VALUES.has(v) ? v : undefined;
+}
 
 export function register(app, { projects, project }) {
   // Vault = global agent templates. Two-layer: bundled defaults shipped with
@@ -128,14 +139,17 @@ export function register(app, { projects, project }) {
   app.post("/projects/:pid/agents", (req, res) => {
     const p = project(req, res);
     if (!p) return;
-    const { slug, role, model, skills, language, description, tools, is_master, parent } =
-      req.body || {};
+    const {
+      slug, role, model, skills, language, description, tools, is_master,
+      parent, type, area, emoji, autonomy,
+    } = req.body || {};
     if (!slug) return res.status(400).json({ error: "slug required" });
     if (!/^[a-z][a-z0-9_-]*$/.test(slug))
       return res.status(400).json({ error: "invalid slug" });
     const existing = readAgents(p.path).find((a) => a.slug === slug);
     if (existing)
       return res.status(400).json({ error: `agent ${slug} already exists` });
+    const autonomyVal = normalizeAutonomy(autonomy);
     try {
       writeAgentFile(p.path, slug, {
         Role: role || null,
@@ -146,6 +160,10 @@ export function register(app, { projects, project }) {
         Tools: tools || [],
         Master: is_master ? true : null,
         Parent: parent || null,
+        Type: type || null,
+        Area: area || null,
+        Emoji: emoji || null,
+        Autonomy: autonomyVal || null,
       });
       ensureAgentDir(p.path, slug);
       ensureAgentRuntimeDir(p, slug);
@@ -179,6 +197,8 @@ export function register(app, { projects, project }) {
     setStr("Parent", b.parent);
     setStr("Type", b.type);
     setStr("Area", b.area);
+    setStr("Emoji", b.emoji);
+    setStr("Autonomy", normalizeAutonomy(b.autonomy));
     if (b.skills !== undefined) fields.Skills = Array.isArray(b.skills) ? b.skills : [];
     if (b.tools !== undefined) fields.Tools = Array.isArray(b.tools) ? b.tools : [];
     if (b.is_master !== undefined) {

package/src/host/daemon/api/files-project.js

@@ -0,0 +1,99 @@
+// Project file browser + docs editor API.
+//
+// A sandboxed view of one project's own files. `scope` selects the sandbox:
+//   project — the whole repo (the /files browser)
+//   docs     — the docs subfolder (config docs.root, default "docs"); powers
+//              the /docs spec editor
+//
+//   GET    /projects/:pid/fs/tree?scope=project|docs
+//   GET    /projects/:pid/fs/file?scope=…&path=<rel>
+//   PUT    /projects/:pid/fs/file        body { scope?, path, content }
+//   POST   /projects/:pid/fs/dir         body { scope?, path }
+//   DELETE /projects/:pid/fs/entry?scope=…&path=<rel>
+//
+// Thin adapter over core/stores/project-files.
+import {
+  listTree,
+  readFile,
+  writeFile,
+  makeDir,
+  removeEntry,
+  docsSubdir,
+} from "#core/stores/project-files.js";
+
+// Resolve the sandbox subdir for a scope. Unknown scope → project root.
+function scopeOpts(p, scope) {
+  if (scope === "docs") return { subdir: docsSubdir(p.config), scope: "docs" };
+  return { subdir: "", scope: "project" };
+}
+
+export function register(app, { project }) {
+  app.get("/projects/:pid/fs/tree", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const { subdir, scope } = scopeOpts(p, req.query?.scope);
+    try {
+      res.json({ scope, ...listTree(p.path, { subdir }) });
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.get("/projects/:pid/fs/file", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const rel = req.query?.path;
+    if (!rel) return res.status(400).json({ error: "path required" });
+    const { subdir } = scopeOpts(p, req.query?.scope);
+    try {
+      const file = readFile(p.path, String(rel), { subdir });
+      if (!file) return res.status(404).json({ error: "file not found" });
+      res.json(file);
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.put("/projects/:pid/fs/file", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const { path: rel, content, scope } = req.body || {};
+    if (!rel) return res.status(400).json({ error: "path required" });
+    if (typeof content !== "string")
+      return res.status(400).json({ error: "content must be a string" });
+    const { subdir } = scopeOpts(p, scope);
+    try {
+      res.json(writeFile(p.path, String(rel), content, { subdir }));
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.post("/projects/:pid/fs/dir", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const { path: rel, scope } = req.body || {};
+    if (!rel) return res.status(400).json({ error: "path required" });
+    const { subdir } = scopeOpts(p, scope);
+    try {
+      res.status(201).json(makeDir(p.path, String(rel), { subdir }));
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.delete("/projects/:pid/fs/entry", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const rel = req.query?.path;
+    if (!rel) return res.status(400).json({ error: "path required" });
+    const { subdir } = scopeOpts(p, req.query?.scope);
+    try {
+      if (!removeEntry(p.path, String(rel), { subdir }))
+        return res.status(404).json({ error: "entry not found" });
+      res.json({ ok: true });
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+}

package/src/host/daemon/api/organization.js

@@ -0,0 +1,88 @@
+// Organization structure (areas + roles) per project.
+//
+//   GET    /projects/:pid/organization                 -> { areas, roles }
+//   POST   /projects/:pid/organization/areas           body { name, slug?, goal? }
+//   PATCH  /projects/:pid/organization/areas/:slug      body { name?, goal? }
+//   DELETE /projects/:pid/organization/areas/:slug      -> { ok }
+//   POST   /projects/:pid/organization/roles           body { name, slug?, area?, description? }
+//   PATCH  /projects/:pid/organization/roles/:slug      body { name?, area?, description? }
+//   DELETE /projects/:pid/organization/roles/:slug      -> { ok }
+//
+// Thin adapter: parse body, call core/stores/organization, shape the response.
+import {
+  readOrganization,
+  createArea,
+  updateArea,
+  removeArea,
+  createRole,
+  updateRole,
+  removeRole,
+} from "#core/stores/organization.js";
+
+export function register(app, { project }) {
+  app.get("/projects/:pid/organization", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    res.json(readOrganization(p.path));
+  });
+
+  app.post("/projects/:pid/organization/areas", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    try {
+      res.status(201).json(createArea(p.path, req.body || {}));
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.patch("/projects/:pid/organization/areas/:slug", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    try {
+      const area = updateArea(p.path, req.params.slug, req.body || {});
+      if (!area) return res.status(404).json({ error: "area not found" });
+      res.json(area);
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.delete("/projects/:pid/organization/areas/:slug", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    if (!removeArea(p.path, req.params.slug))
+      return res.status(404).json({ error: "area not found" });
+    res.json({ ok: true });
+  });
+
+  app.post("/projects/:pid/organization/roles", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    try {
+      res.status(201).json(createRole(p.path, req.body || {}));
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.patch("/projects/:pid/organization/roles/:slug", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    try {
+      const role = updateRole(p.path, req.params.slug, req.body || {});
+      if (!role) return res.status(404).json({ error: "role not found" });
+      res.json(role);
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.delete("/projects/:pid/organization/roles/:slug", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    if (!removeRole(p.path, req.params.slug))
+      return res.status(404).json({ error: "role not found" });
+    res.json({ ok: true });
+  });
+}

package/src/host/daemon/api/shared.js

@@ -210,6 +210,8 @@ export function agentToResponse(a) {
     "Parent",
     "Type",
     "Area",
+    "Emoji",
+    "Autonomy",
   ]);
   const extra = {};
   for (const [k, v] of Object.entries(f)) {
@@ -229,6 +231,11 @@ export function agentToResponse(a) {
     // definitional, kept in APC frontmatter.
     type: f.Type || null,
     area: f.Area || null,
+    // Display emoji (avatar) + autonomy (permission mode: total/automatico/
+    // permiso). Definitional, kept in APC frontmatter so they travel with the
+    // project and stay diffable.
+    emoji: f.Emoji || null,
+    autonomy: f.Autonomy || null,
     skills: Array.isArray(f.Skills) ? f.Skills : [],
     tools: Array.isArray(f.Tools) ? f.Tools : [],
     extra,