@aexol/spectral 0.9.172 → 0.9.174

package/dist/server/storage.js

@@ -190,8 +190,16 @@ export class SessionStore {
     db;
     closed = false;
     // Project statements
+    stmtListProjectsSQL = `
+      SELECT p.id, p.name, p.path, p.created_at, p.updated_at,
+             p.studio_project_id, p.studio_project_name, p.studio_team_id,
+             (SELECT COUNT(*) FROM sessions s WHERE s.project_id = p.id) AS session_count
+      FROM projects p
+      ORDER BY p.updated_at DESC
+    `;
     stmtListProjects;
     stmtGetProject;
+    stmtCountSessionsByProject;
     stmtCreateProject;
     stmtUpdateProject;
     stmtSetProjectStudioBinding;
@@ -375,6 +383,7 @@ export class SessionStore {
       ORDER BY p.updated_at DESC
     `);
         this.stmtGetProject = this.db.prepare(`SELECT id, name, path, created_at, updated_at, studio_project_id, studio_project_name, studio_team_id FROM projects WHERE id = ?`);
+        this.stmtCountSessionsByProject = this.db.prepare(`SELECT COUNT(*) AS count FROM sessions WHERE project_id = ?`);
         this.stmtCreateProject = this.db.prepare(`INSERT INTO projects (id, name, path, created_at, updated_at) VALUES (?, ?, ?, ?, ?)`);
         this.stmtUpdateProject = this.db.prepare(`UPDATE projects SET name = ?, path = ?, updated_at = ? WHERE id = ?`);
         this.stmtSetProjectStudioBinding = this.db.prepare(`UPDATE projects SET studio_project_id = ?, studio_project_name = ?, studio_team_id = ?, updated_at = ? WHERE id = ?`);
@@ -500,11 +509,9 @@ export class SessionStore {
             .all();
         return rows.map((r) => r.name);
     }
-    // ----------------------------------------------------------------------
-    // Projects
-    // ----------------------------------------------------------------------
-    listProjects() {
-        return this.stmtListProjects.all().map((r) => {
+    /** Shared row→WireProject mapping for the synchronous and async list paths. */
+    mapProjectRowsWithCount(rows) {
+        return rows.map((r) => {
             const project = {
                 id: r.id,
                 name: r.name,
@@ -523,6 +530,21 @@ export class SessionStore {
             return applyBindingFields(project, rowBinding);
         });
     }
+    // ----------------------------------------------------------------------
+    // Projects
+    // ----------------------------------------------------------------------
+    listProjects() {
+        return this.mapProjectRowsWithCount(this.stmtListProjects.all());
+    }
+    /**
+     * Async twin of {@link listProjects}. Uses the adapter's `queryAll`
+     * trampoline so the Node adapter yields to the event loop before the
+     * potentially-large aggregate query runs. Wire shape is identical.
+     */
+    async listProjectsAsync() {
+        const rows = await this.db.queryAll(this.stmtListProjectsSQL);
+        return this.mapProjectRowsWithCount(rows);
+    }
     createProject(input) {
         const id = input.id ?? randomUUID();
         const name = input.name.trim() || "Untitled project";
@@ -543,15 +565,40 @@ export class SessionStore {
         const row = this.stmtGetProject.get(id);
         if (!row)
             return null;
-        // Re-fetch with count to keep the wire shape consistent. Cheap.
-        const withCount = this.stmtListProjects.all().find((r) => r.id === id);
+        const withCount = this.stmtCountSessionsByProject.get(id);
+        const project = {
+            id: row.id,
+            name: row.name,
+            path: row.path,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            sessionCount: withCount?.count ?? 0,
+        };
+        const rowBinding = row.studio_project_id
+            ? {
+                projectId: row.studio_project_id,
+                ...(row.studio_project_name ? { name: row.studio_project_name } : {}),
+                ...(row.studio_team_id ? { teamId: row.studio_team_id } : {}),
+            }
+            : null;
+        return applyBindingFields(project, rowBinding);
+    }
+    /** Async twin of {@link getProject}. */
+    async getProjectAsync(id) {
+        const rows = await this.db.queryAll(`SELECT id, name, path, created_at, updated_at,
+              studio_project_id, studio_project_name, studio_team_id
+       FROM projects WHERE id = ?`, id);
+        const row = rows[0];
+        if (!row)
+            return null;
+        const countRows = await this.db.queryAll(`SELECT COUNT(*) AS count FROM sessions WHERE project_id = ?`, id);
         const project = {
             id: row.id,
             name: row.name,
             path: row.path,
             createdAt: row.created_at,
             updatedAt: row.updated_at,
-            sessionCount: withCount?.session_count ?? 0,
+            sessionCount: countRows[0]?.count ?? 0,
         };
         const rowBinding = row.studio_project_id
             ? {
@@ -607,6 +654,22 @@ export class SessionStore {
             messageCount: r.message_count,
         }));
     }
+    /** Async twin of {@link listSessionsByProject}. */
+    async listSessionsByProjectAsync(projectId) {
+        const rows = await this.db.queryAll(`SELECT s.id, s.project_id, s.title, s.created_at, s.updated_at,
+             (SELECT COUNT(*) FROM messages m WHERE m.session_id = s.id) AS message_count
+       FROM sessions s
+       WHERE s.project_id = ?
+       ORDER BY s.updated_at DESC`, projectId);
+        return rows.map((r) => ({
+            id: r.id,
+            projectId: r.project_id,
+            title: r.title,
+            createdAt: r.created_at,
+            updatedAt: r.updated_at,
+            messageCount: r.message_count,
+        }));
+    }
     /**
      * Batched variant of {@link listSessionsByProject} for many projects at once.
      *
@@ -654,6 +717,42 @@ export class SessionStore {
         }
         return result;
     }
+    /**
+     * Async twin of {@link listSessionsByProjectIds}. Runs the same single
+     * LEFT JOIN + GROUP BY query through the adapter trampoline so large
+     * aggregate reads yield to the event loop. Returns an identical Map with
+     * every requested project id present (empty arrays for projects with no
+     * sessions) and identical per-project `updated_at DESC` ordering.
+     */
+    async listSessionsByProjectIdsAsync(projectIds) {
+        const result = new Map();
+        for (const id of projectIds)
+            result.set(id, []);
+        if (projectIds.length === 0)
+            return result;
+        const placeholders = projectIds.map(() => "?").join(", ");
+        const rows = await this.db.queryAll(`SELECT s.id, s.project_id, s.title, s.created_at, s.updated_at,
+              COUNT(m.id) AS message_count
+       FROM sessions s
+       LEFT JOIN messages m ON m.session_id = s.id
+       WHERE s.project_id IN (${placeholders})
+       GROUP BY s.id, s.project_id, s.title, s.created_at, s.updated_at
+       ORDER BY s.updated_at DESC, s.created_at DESC, s.id DESC`, ...projectIds);
+        for (const r of rows) {
+            const list = result.get(r.project_id);
+            if (!list)
+                continue;
+            list.push({
+                id: r.id,
+                projectId: r.project_id,
+                title: r.title,
+                createdAt: r.created_at,
+                updatedAt: r.updated_at,
+                messageCount: r.message_count,
+            });
+        }
+        return result;
+    }
     // ----------------------------------------------------------------------
     // Sessions
     // ----------------------------------------------------------------------
@@ -727,6 +826,34 @@ export class SessionStore {
             updatedAt: row.updated_at,
         };
     }
+    /** Async twin of {@link getSessionMeta}. */
+    async getSessionMetaAsync(id) {
+        const rows = await this.db.queryAll(`SELECT id, project_id, title, created_at, updated_at
+       FROM sessions WHERE id = ?`, id);
+        const row = rows[0];
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            projectId: row.project_id,
+            title: row.title,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    /** Async twin of {@link getMessages} with a caller-supplied bound. */
+    async getMessagesTailAsync(sessionId, limit) {
+        const rows = await this.db.queryAll(`SELECT id, session_id, role, content, events_jsonl, images_json, credits_used, created_at
+       FROM (
+         SELECT id, session_id, role, content, events_jsonl, images_json, credits_used, created_at
+         FROM messages
+         WHERE session_id = ?
+         ORDER BY created_at DESC, id DESC
+         LIMIT ?
+       )
+       ORDER BY created_at ASC, id ASC`, sessionId, limit);
+        return this.mapMessageRows(rows);
+    }
     getMessages(sessionId) {
         return this.mapMessageRows(this.stmtListMessages.all(sessionId));
     }
@@ -738,9 +865,30 @@ export class SessionStore {
             return [];
         return this.mapMessageRows(this.stmtListMessagesBefore.all(sessionId, opts.beforeCreatedAt, opts.beforeCreatedAt, opts.beforeId ?? "\uffff", opts.limit));
     }
+    /** Async twin of {@link getMessagesBefore}. */
+    async getMessagesBeforeAsync(sessionId, opts) {
+        if (opts.beforeCreatedAt === null)
+            return [];
+        const rows = await this.db.queryAll(`SELECT id, session_id, role, content, events_jsonl, images_json, credits_used, created_at
+       FROM (
+         SELECT id, session_id, role, content, events_jsonl, images_json, credits_used, created_at
+         FROM messages
+         WHERE session_id = ?
+           AND (created_at < ? OR (created_at = ? AND id < ?))
+         ORDER BY created_at DESC, id DESC
+         LIMIT ?
+       )
+       ORDER BY created_at ASC, id ASC`, sessionId, opts.beforeCreatedAt, opts.beforeCreatedAt, opts.beforeId ?? "\uffff", opts.limit);
+        return this.mapMessageRows(rows);
+    }
     countMessagesBySession(sessionId) {
         return this.stmtCountMessagesBySession.get(sessionId)?.count ?? 0;
     }
+    /** Async twin of {@link countMessagesBySession}. */
+    async countMessagesBySessionAsync(sessionId) {
+        const rows = await this.db.queryAll(`SELECT COUNT(*) AS count FROM messages WHERE session_id = ?`, sessionId);
+        return rows[0]?.count ?? 0;
+    }
     mapMessageRows(rows) {
         return rows.map((r) => {
             const images = parseImagesJson(r.images_json);
@@ -952,6 +1100,11 @@ export class SessionStore {
     getSessionActiveAgent(sessionId) {
         return this.stmtGetSessionActiveAgent.get(sessionId)?.active_agent ?? null;
     }
+    /** Async twin of {@link getSessionActiveAgent}. */
+    async getSessionActiveAgentAsync(sessionId) {
+        const rows = await this.db.queryAll(`SELECT active_agent FROM sessions WHERE id = ?`, sessionId);
+        return rows[0]?.active_agent ?? null;
+    }
     setSessionActiveAgent(sessionId, agentName) {
         this.stmtSetSessionActiveAgent.run(agentName, sessionId);
     }
@@ -1035,6 +1188,11 @@ export class SessionStore {
         const row = this.stmtGetForkCompactSource.get(sessionId);
         return row?.fork_compact_source_id ?? null;
     }
+    /** Async twin of {@link getForkCompactSource}. */
+    async getForkCompactSourceAsync(sessionId) {
+        const rows = await this.db.queryAll(`SELECT fork_compact_source_id FROM sessions WHERE id = ?`, sessionId);
+        return rows[0]?.fork_compact_source_id ?? null;
+    }
     /**
      * Clear the fork-compact flag after compaction completes (or fails).
      * Idempotent-safe.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.172",
+  "version": "0.9.174",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,