Implement agent hiring, approval workflows, config revisions, LLM reflection, and sidebar badges
Agent management: hire endpoint with permission gates and pending_approval status,
config revision tracking with rollback, agent duplicate route, permission CRUD.
Block pending_approval agents from auth, heartbeat, and assignments.
Approvals: revision request/resubmit flow, approval comments CRUD, issue-approval
linking, auto-wake agents on approval decisions with context snapshot.
Costs: per-agent breakdown, period filtering (month/week/day/all), cost by agent
list endpoint.
Adapters: agentConfigurationDoc on all adapters, /llms/agent-configuration.txt
reflection routes. Inject PAPERCLIP_APPROVAL_ID, PAPERCLIP_APPROVAL_STATUS,
PAPERCLIP_LINKED_ISSUE_IDS into adapter environments.
Sidebar badges endpoint for pending approval/inbox counts. Dashboard and company
settings extensions.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 13:02:41 -06:00
|
|
|
import { and, eq, gte, sql } from "drizzle-orm";
|
2026-03-03 08:45:26 -06:00
|
|
|
import type { Db } from "@paperclipai/db";
|
|
|
|
|
import { agents, approvals, companies, costEvents, issues } from "@paperclipai/db";
|
Add server routes for companies, approvals, costs, and dashboard
New routes: companies, approvals, costs, dashboard, authz. New
services: companies, approvals, costs, dashboard, heartbeat,
activity-log. Add auth middleware and structured error handling.
Expand existing agent and issue routes with richer CRUD operations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 09:07:27 -06:00
|
|
|
import { notFound } from "../errors.js";
|
2026-03-14 22:00:12 -05:00
|
|
|
import { budgetService } from "./budgets.js";
|
Add server routes for companies, approvals, costs, and dashboard
New routes: companies, approvals, costs, dashboard, authz. New
services: companies, approvals, costs, dashboard, heartbeat,
activity-log. Add auth middleware and structured error handling.
Expand existing agent and issue routes with richer CRUD operations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 09:07:27 -06:00
|
|
|
|
|
|
|
|
export function dashboardService(db: Db) {
|
2026-03-14 22:00:12 -05:00
|
|
|
const budgets = budgetService(db);
|
Add server routes for companies, approvals, costs, and dashboard
New routes: companies, approvals, costs, dashboard, authz. New
services: companies, approvals, costs, dashboard, heartbeat,
activity-log. Add auth middleware and structured error handling.
Expand existing agent and issue routes with richer CRUD operations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 09:07:27 -06:00
|
|
|
return {
|
|
|
|
|
summary: async (companyId: string) => {
|
|
|
|
|
const company = await db
|
|
|
|
|
.select()
|
|
|
|
|
.from(companies)
|
|
|
|
|
.where(eq(companies.id, companyId))
|
|
|
|
|
.then((rows) => rows[0] ?? null);
|
|
|
|
|
|
|
|
|
|
if (!company) throw notFound("Company not found");
|
|
|
|
|
|
|
|
|
|
const agentRows = await db
|
|
|
|
|
.select({ status: agents.status, count: sql<number>`count(*)` })
|
|
|
|
|
.from(agents)
|
|
|
|
|
.where(eq(agents.companyId, companyId))
|
|
|
|
|
.groupBy(agents.status);
|
|
|
|
|
|
|
|
|
|
const taskRows = await db
|
|
|
|
|
.select({ status: issues.status, count: sql<number>`count(*)` })
|
|
|
|
|
.from(issues)
|
|
|
|
|
.where(eq(issues.companyId, companyId))
|
|
|
|
|
.groupBy(issues.status);
|
|
|
|
|
|
|
|
|
|
const pendingApprovals = await db
|
|
|
|
|
.select({ count: sql<number>`count(*)` })
|
|
|
|
|
.from(approvals)
|
|
|
|
|
.where(and(eq(approvals.companyId, companyId), eq(approvals.status, "pending")))
|
|
|
|
|
.then((rows) => Number(rows[0]?.count ?? 0));
|
|
|
|
|
|
|
|
|
|
const agentCounts: Record<string, number> = {
|
|
|
|
|
active: 0,
|
|
|
|
|
running: 0,
|
|
|
|
|
paused: 0,
|
|
|
|
|
error: 0,
|
|
|
|
|
};
|
|
|
|
|
for (const row of agentRows) {
|
2026-02-19 14:39:48 -06:00
|
|
|
const count = Number(row.count);
|
|
|
|
|
// "idle" agents are operational — count them as active
|
|
|
|
|
const bucket = row.status === "idle" ? "active" : row.status;
|
|
|
|
|
agentCounts[bucket] = (agentCounts[bucket] ?? 0) + count;
|
Add server routes for companies, approvals, costs, and dashboard
New routes: companies, approvals, costs, dashboard, authz. New
services: companies, approvals, costs, dashboard, heartbeat,
activity-log. Add auth middleware and structured error handling.
Expand existing agent and issue routes with richer CRUD operations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 09:07:27 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
const taskCounts: Record<string, number> = {
|
|
|
|
|
open: 0,
|
|
|
|
|
inProgress: 0,
|
|
|
|
|
blocked: 0,
|
|
|
|
|
done: 0,
|
|
|
|
|
};
|
|
|
|
|
for (const row of taskRows) {
|
|
|
|
|
const count = Number(row.count);
|
|
|
|
|
if (row.status === "in_progress") taskCounts.inProgress += count;
|
|
|
|
|
if (row.status === "blocked") taskCounts.blocked += count;
|
|
|
|
|
if (row.status === "done") taskCounts.done += count;
|
|
|
|
|
if (row.status !== "done" && row.status !== "cancelled") taskCounts.open += count;
|
|
|
|
|
}
|
|
|
|
|
|
Implement agent hiring, approval workflows, config revisions, LLM reflection, and sidebar badges
Agent management: hire endpoint with permission gates and pending_approval status,
config revision tracking with rollback, agent duplicate route, permission CRUD.
Block pending_approval agents from auth, heartbeat, and assignments.
Approvals: revision request/resubmit flow, approval comments CRUD, issue-approval
linking, auto-wake agents on approval decisions with context snapshot.
Costs: per-agent breakdown, period filtering (month/week/day/all), cost by agent
list endpoint.
Adapters: agentConfigurationDoc on all adapters, /llms/agent-configuration.txt
reflection routes. Inject PAPERCLIP_APPROVAL_ID, PAPERCLIP_APPROVAL_STATUS,
PAPERCLIP_LINKED_ISSUE_IDS into adapter environments.
Sidebar badges endpoint for pending approval/inbox counts. Dashboard and company
settings extensions.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 13:02:41 -06:00
|
|
|
const now = new Date();
|
|
|
|
|
const monthStart = new Date(now.getFullYear(), now.getMonth(), 1);
|
|
|
|
|
const [{ monthSpend }] = await db
|
|
|
|
|
.select({
|
|
|
|
|
monthSpend: sql<number>`coalesce(sum(${costEvents.costCents}), 0)::int`,
|
|
|
|
|
})
|
|
|
|
|
.from(costEvents)
|
|
|
|
|
.where(
|
|
|
|
|
and(
|
|
|
|
|
eq(costEvents.companyId, companyId),
|
|
|
|
|
gte(costEvents.occurredAt, monthStart),
|
|
|
|
|
),
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
const monthSpendCents = Number(monthSpend);
|
Add server routes for companies, approvals, costs, and dashboard
New routes: companies, approvals, costs, dashboard, authz. New
services: companies, approvals, costs, dashboard, heartbeat,
activity-log. Add auth middleware and structured error handling.
Expand existing agent and issue routes with richer CRUD operations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 09:07:27 -06:00
|
|
|
const utilization =
|
|
|
|
|
company.budgetMonthlyCents > 0
|
Implement agent hiring, approval workflows, config revisions, LLM reflection, and sidebar badges
Agent management: hire endpoint with permission gates and pending_approval status,
config revision tracking with rollback, agent duplicate route, permission CRUD.
Block pending_approval agents from auth, heartbeat, and assignments.
Approvals: revision request/resubmit flow, approval comments CRUD, issue-approval
linking, auto-wake agents on approval decisions with context snapshot.
Costs: per-agent breakdown, period filtering (month/week/day/all), cost by agent
list endpoint.
Adapters: agentConfigurationDoc on all adapters, /llms/agent-configuration.txt
reflection routes. Inject PAPERCLIP_APPROVAL_ID, PAPERCLIP_APPROVAL_STATUS,
PAPERCLIP_LINKED_ISSUE_IDS into adapter environments.
Sidebar badges endpoint for pending approval/inbox counts. Dashboard and company
settings extensions.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 13:02:41 -06:00
|
|
|
? (monthSpendCents / company.budgetMonthlyCents) * 100
|
Add server routes for companies, approvals, costs, and dashboard
New routes: companies, approvals, costs, dashboard, authz. New
services: companies, approvals, costs, dashboard, heartbeat,
activity-log. Add auth middleware and structured error handling.
Expand existing agent and issue routes with richer CRUD operations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 09:07:27 -06:00
|
|
|
: 0;
|
2026-03-14 22:00:12 -05:00
|
|
|
const budgetOverview = await budgets.overview(companyId);
|
Add server routes for companies, approvals, costs, and dashboard
New routes: companies, approvals, costs, dashboard, authz. New
services: companies, approvals, costs, dashboard, heartbeat,
activity-log. Add auth middleware and structured error handling.
Expand existing agent and issue routes with richer CRUD operations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 09:07:27 -06:00
|
|
|
|
|
|
|
|
return {
|
|
|
|
|
companyId,
|
|
|
|
|
agents: {
|
|
|
|
|
active: agentCounts.active,
|
|
|
|
|
running: agentCounts.running,
|
|
|
|
|
paused: agentCounts.paused,
|
|
|
|
|
error: agentCounts.error,
|
|
|
|
|
},
|
|
|
|
|
tasks: taskCounts,
|
|
|
|
|
costs: {
|
Implement agent hiring, approval workflows, config revisions, LLM reflection, and sidebar badges
Agent management: hire endpoint with permission gates and pending_approval status,
config revision tracking with rollback, agent duplicate route, permission CRUD.
Block pending_approval agents from auth, heartbeat, and assignments.
Approvals: revision request/resubmit flow, approval comments CRUD, issue-approval
linking, auto-wake agents on approval decisions with context snapshot.
Costs: per-agent breakdown, period filtering (month/week/day/all), cost by agent
list endpoint.
Adapters: agentConfigurationDoc on all adapters, /llms/agent-configuration.txt
reflection routes. Inject PAPERCLIP_APPROVAL_ID, PAPERCLIP_APPROVAL_STATUS,
PAPERCLIP_LINKED_ISSUE_IDS into adapter environments.
Sidebar badges endpoint for pending approval/inbox counts. Dashboard and company
settings extensions.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 13:02:41 -06:00
|
|
|
monthSpendCents,
|
Add server routes for companies, approvals, costs, and dashboard
New routes: companies, approvals, costs, dashboard, authz. New
services: companies, approvals, costs, dashboard, heartbeat,
activity-log. Add auth middleware and structured error handling.
Expand existing agent and issue routes with richer CRUD operations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 09:07:27 -06:00
|
|
|
monthBudgetCents: company.budgetMonthlyCents,
|
|
|
|
|
monthUtilizationPercent: Number(utilization.toFixed(2)),
|
|
|
|
|
},
|
|
|
|
|
pendingApprovals,
|
2026-03-14 22:00:12 -05:00
|
|
|
budgets: {
|
|
|
|
|
activeIncidents: budgetOverview.activeIncidents.length,
|
|
|
|
|
pendingApprovals: budgetOverview.pendingApprovalCount,
|
|
|
|
|
pausedAgents: budgetOverview.pausedAgentCount,
|
|
|
|
|
pausedProjects: budgetOverview.pausedProjectCount,
|
|
|
|
|
},
|
Add server routes for companies, approvals, costs, and dashboard
New routes: companies, approvals, costs, dashboard, authz. New
services: companies, approvals, costs, dashboard, heartbeat,
activity-log. Add auth middleware and structured error handling.
Expand existing agent and issue routes with richer CRUD operations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 09:07:27 -06:00
|
|
|
};
|
|
|
|
|
},
|
|
|
|
|
};
|
|
|
|
|
}
|