@agentprojectcontext/apx 1.47.0 → 1.48.1

package/package.json

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

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

@@ -13,20 +13,22 @@ import {
   createAgentSessionFile,
 } from "#core/stores/sessions.js";
 import { collectAllSessions } from "#interfaces/cli/commands/sessions.js";
+import { pageEnvelope } from "./shared.js";
 
 export function register(app, { projects, project }) {
-  // Cross-engine sessions (apx · claude · codex), newest first.
+  // Cross-engine sessions (apx · claude · codex), newest first. Returns a
+  // { meta, data } envelope (meta = pagination info, data = rows). Paginated
+  // via ?limit & ?offset; with no limit, data is the full set as one page.
   app.get("/sessions", (req, res) => {
     const engineId = req.query.engine ? String(req.query.engine) : null;
-    const limit = Math.min(parseInt(req.query.limit, 10) || 200, 1000);
     let rows = [];
     try {
       rows = collectAllSessions({}, { engineId });
     } catch (e) {
-      return res.status(500).json({ error: e.message, sessions: [] });
+      return res.status(500).json({ error: e.message, meta: { total: 0, offset: 0, limit: null, pageSize: 0, page: 1, pageCount: 1 }, data: [] });
     }
     rows.sort((a, b) => (b.mtime || 0) - (a.mtime || 0));
-    res.json({ sessions: rows.slice(0, limit) });
+    res.json(pageEnvelope(rows, req.query));
   });
 
   app.get("/projects/:pid/agents/:slug/sessions", (req, res) => {

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

@@ -14,6 +14,30 @@ import { CHANNELS } from "#core/constants/channels.js";
 export const nowIso = () =>
   new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
 
+// Build a { meta, data } pagination envelope from an already-sorted array.
+// Reads ?limit & ?offset from the request query. With no `limit`, returns the
+// full set as a single page (data = 100% of rows) so non-paginated callers get
+// the same shape — meta just reports one page covering everything.
+//   meta: { total, offset, limit, pageSize, page, pageCount }
+export function pageEnvelope(rows, query = {}) {
+  const total = rows.length;
+  const hasLimit = query.limit != null && query.limit !== "";
+  const limit = hasLimit ? Math.min(Math.max(parseInt(query.limit, 10) || 0, 0), 1000) : null;
+  const offset = Math.max(parseInt(query.offset, 10) || 0, 0);
+  const data = limit != null ? rows.slice(offset, offset + limit) : rows.slice(offset);
+  return {
+    meta: {
+      total,
+      offset,
+      limit,
+      pageSize: limit != null ? limit : total,
+      page: limit ? Math.floor(offset / limit) + 1 : 1,
+      pageCount: limit ? Math.max(1, Math.ceil(total / limit)) : 1,
+    },
+    data,
+  };
+}
+
 // Trace id middleware — populates req.apxTraceId and echoes it on the response.
 export function traceIdMiddleware(req, res, next) {
   req.apxTraceId = req.get("x-apx-trace-id") || randomUUID();

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

@@ -16,9 +16,12 @@ import {
   reopenTask,
   countTasks,
 } from "#core/stores/tasks.js";
+import { pageEnvelope } from "./shared.js";
 
 export function register(app, { project, projects }) {
-  // Global tasks across every project.
+  // Global tasks across every project, newest first. Returns a { meta, data }
+  // envelope. Paginated via ?limit & ?offset; with no limit, data is the full
+  // set as one page.
   app.get("/tasks", (req, res) => {
     const state = req.query.state || "open";
     const out = [];
@@ -29,27 +32,28 @@ export function register(app, { project, projects }) {
       try {
         tasks = listTasks(p.storagePath, {
           state: state === "all" ? undefined : state,
-          limit: 500,
         });
       } catch { /* skip project */ }
       for (const t of tasks) out.push({ ...t, project_id: entry.id, project_name: entry.name || entry.path });
     }
-    res.json(out);
+    out.sort((a, b) => (b.created_at || "").localeCompare(a.created_at || ""));
+    res.json(pageEnvelope(out, req.query));
   });
 
+  // Per-project tasks. Returns a { meta, data } envelope; with no ?limit the
+  // data array is the full filtered set (one page).
   app.get("/projects/:pid/tasks", (req, res) => {
     const p = project(req, res);
     if (!p) return;
-    const { state, tag, agent, due_before, due_after, limit } = req.query;
-    const out = listTasks(p.storagePath, {
+    const { state, tag, agent, due_before, due_after } = req.query;
+    const all = listTasks(p.storagePath, {
       state: state || undefined,
       tag: tag || undefined,
       agent: agent || undefined,
       due_before: due_before || undefined,
       due_after: due_after || undefined,
-      limit: limit ? Math.min(parseInt(limit, 10) || 0, 1000) : undefined,
     });
-    res.json(out);
+    res.json(pageEnvelope(all, req.query));
   });
 
   app.post("/projects/:pid/tasks", (req, res) => {