agent-tool-forge 0.4.1 → 0.4.3

package/lib/forge-service.js

@@ -207,11 +207,14 @@ function serveWidgetFile(req, res, widgetDir, errorFn) {
  * @param {object} [options]
  * @param {string} [options.widgetDir] — directory for /widget/* static files (defaults to <project>/widget)
  * @param {function} [options.mcpHandler] — optional async (req, res) handler for /mcp route
+ * @param {function} [options.customRoutes] — optional async (req, res, ctx) => boolean; called before
+ *   the 404 fallback. Return true if the request was handled, false to fall through to 404.
  * @returns {function(import('http').IncomingMessage, import('http').ServerResponse): Promise<void>}
  */
 export function createSidecarRouter(ctx, options = {}) {
   const widgetDir = options.widgetDir || resolve(__dirname, '..', 'widget');
   const mcpHandler = options.mcpHandler || null;
+  const customRoutes = options.customRoutes || null;
 
   return async (req, res) => {
     const url = new URL(req.url, 'http://localhost');
@@ -267,6 +270,12 @@ export function createSidecarRouter(ctx, options = {}) {
       return;
     }
 
+    // ── Custom routes (consumer-provided) ─────────────────────────────────
+    if (customRoutes) {
+      const handled = await customRoutes(req, res, ctx);
+      if (handled) return;
+    }
+
     // ── 404 fallback ───────────────────────────────────────────────────────
     sendJson(res, 404, { error: 'not found' });
   };

package/lib/postgres-store.js

@@ -241,21 +241,6 @@ export class PostgresStore {
       `UPDATE tool_registry SET ${sets.join(', ')} WHERE tool_name = $${i}`, vals);
   }
 
-  // ── Verifier results ──────────────────────────────────────────────────
-
-  async insertVerifierResult(row) {
-    const { rows } = await this._pool.query(
-      `INSERT INTO verifier_results
-         (session_id, tool_name, verifier_name, outcome, message, tool_call_input, tool_call_output, created_at)
-       VALUES ($1, $2, $3, $4, $5, $6, $7, $8) RETURNING id`,
-      [
-        row.session_id ?? null, row.tool_name, row.verifier_name, row.outcome,
-        row.message ?? null, row.tool_call_input ?? null, row.tool_call_output ?? null,
-        new Date().toISOString()
-      ]
-    );
-    return rows[0]?.id ?? null;
-  }
 }
 
 // ── PostgresPromptStore ────────────────────────────────────────────────────
@@ -611,6 +596,14 @@ export class PostgresEvalStore {
     );
     return rows;
   }
+
+  async listRuns(limit = 50, offset = 0) {
+    const { rows } = await this._pool.query(
+      `SELECT * FROM eval_runs ORDER BY run_at DESC LIMIT $1 OFFSET $2`,
+      [limit, offset]
+    );
+    return rows;
+  }
 }
 
 // ── PostgresChatAuditStore ─────────────────────────────────────────────────
@@ -636,6 +629,35 @@ export class PostgresChatAuditStore {
     );
     return rows[0]?.id ?? null;
   }
+
+  async getStats() {
+    const { rows } = await this._pool.query(`
+      SELECT
+        COUNT(*) AS total_sessions,
+        COALESCE(AVG(duration_ms), 0) AS avg_duration_ms,
+        COALESCE(
+          COUNT(*) FILTER (WHERE status_code >= 400)::float / NULLIF(COUNT(*), 0),
+          0
+        ) AS error_rate,
+        COUNT(*) FILTER (WHERE created_at >= NOW() - INTERVAL '24 hours') AS messages_today
+      FROM chat_audit
+    `);
+    const row = rows[0];
+    return {
+      totalSessions: parseInt(row.total_sessions, 10),
+      avgDurationMs: Math.round(parseFloat(row.avg_duration_ms)),
+      errorRate: parseFloat(row.error_rate),
+      messagesToday: parseInt(row.messages_today, 10)
+    };
+  }
+
+  async getSessions(limit = 20, offset = 0) {
+    const { rows } = await this._pool.query(
+      `SELECT * FROM chat_audit ORDER BY created_at DESC LIMIT $1 OFFSET $2`,
+      [limit, offset]
+    );
+    return rows;
+  }
 }
 
 // ── PostgresVerifierStore ──────────────────────────────────────────────────
@@ -724,4 +746,31 @@ export class PostgresVerifierStore {
       `SELECT * FROM verifier_tool_bindings WHERE verifier_name = $1`, [verifierName]);
     return rows;
   }
+
+  async insertVerifierResult(row) {
+    const { rows } = await this._pool.query(
+      `INSERT INTO verifier_results
+         (session_id, tool_name, verifier_name, outcome, message, tool_call_input, tool_call_output, created_at)
+       VALUES ($1,$2,$3,$4,$5,$6,$7,$8) RETURNING id`,
+      [row.session_id ?? null, row.tool_name, row.verifier_name, row.outcome,
+       row.message ?? null, row.tool_call_input ?? null, row.tool_call_output ?? null,
+       new Date().toISOString()]
+    );
+    return rows[0]?.id ?? null;
+  }
+
+  async getResults(toolName = null, limit = 100) {
+    if (toolName) {
+      const { rows } = await this._pool.query(
+        `SELECT * FROM verifier_results WHERE tool_name = $1 ORDER BY created_at DESC LIMIT $2`,
+        [toolName, limit]
+      );
+      return rows;
+    }
+    const { rows } = await this._pool.query(
+      `SELECT * FROM verifier_results ORDER BY created_at DESC LIMIT $1`,
+      [limit]
+    );
+    return rows;
+  }
 }

package/lib/sidecar.js

@@ -29,6 +29,8 @@ import { createDriftMonitor } from './drift-background.js';
  * @param {boolean} [options.autoListen=true] — start listening immediately
  * @param {boolean} [options.enableDrift=false] — start background drift monitor
  * @param {string} [options.widgetDir] — custom widget directory
+ * @param {function} [options.customRoutes] — async (req, res, ctx) => boolean; inject custom routes
+ *   before the built-in 404 handler. Return true if the request was handled, false to fall through.
  * @returns {Promise<{ server: import('http').Server, ctx: object, close: () => void }>}
  */
 export async function createSidecar(config = {}, options = {}) {
@@ -40,6 +42,7 @@ export async function createSidecar(config = {}, options = {}) {
     autoListen = true,
     enableDrift = false,
     widgetDir,
+    customRoutes,
   } = options;
 
   // Merge defaults first so validateConfig sees a fully-populated object (M1).
@@ -69,6 +72,7 @@ export async function createSidecar(config = {}, options = {}) {
   // Build request handler
   const routerOpts = {};
   if (widgetDir) routerOpts.widgetDir = widgetDir;
+  if (customRoutes) routerOpts.customRoutes = customRoutes;
   const router = createSidecarRouter(ctx, routerOpts);
 
   // Create HTTP server

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-tool-forge",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Production LLM agent sidecar + Claude Code skill library for building, testing, and running tool-calling agents.",
   "keywords": [
     "llm",