manifest 5.3.4 → 5.6.0

package/README.md

@@ -1,48 +1,44 @@
 # Manifest
 
-Observability plugin for [OpenClaw](https://github.com/open-claw/open-claw). Collects traces, metrics, and cost data from your AI agent and exports them to [Manifest](https://manifest.build) via OTLP/HTTP.
+Observability plugin for [OpenClaw](https://github.com/open-claw/open-claw). Collects traces, metrics, and cost data from your AI agent and displays them in a local dashboard — zero configuration required.
 
 ## Install
 
 ```bash
 openclaw plugins install manifest
-openclaw config set plugins.entries.manifest.config.apiKey "mnfst_YOUR_KEY"
 openclaw gateway restart
 ```
 
-Or with environment variables:
-
-```bash
-export MANIFEST_API_KEY=mnfst_YOUR_KEY
-```
+That's it. The plugin starts an embedded server with SQLite at `http://127.0.0.1:2099`. Open that URL to see your dashboard.
 
-## Local mode
+### Cloud mode
 
-Run the full Manifest dashboard locally — no cloud account needed. Data is stored in SQLite at `~/.openclaw/manifest/`.
+To send telemetry to the hosted platform at [app.manifest.build](https://app.manifest.build) instead:
 
 ```bash
-openclaw plugins install manifest
-openclaw config set plugins.entries.manifest.config.mode "local"
+openclaw config set plugins.entries.manifest.config.mode cloud
+openclaw config set plugins.entries.manifest.config.apiKey "mnfst_YOUR_KEY"
 openclaw gateway restart
 ```
 
-Open `http://127.0.0.1:2099` to view the dashboard.
+Or with environment variables:
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `mode` | string | `cloud` | `local` for embedded server, `cloud` for hosted |
-| `port` | number | `2099` | Local server port |
-| `host` | string | `127.0.0.1` | Local server bind address |
+```bash
+export MANIFEST_API_KEY=mnfst_YOUR_KEY
+```
 
 ## Configuration
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `apiKey` | string | env `MANIFEST_API_KEY` | Agent API key (`mnfst_*`) |
-| `endpoint` | string | `https://app.manifest.build/api/v1/otlp` | OTLP endpoint URL |
+| `mode` | string | `local` | `local` for embedded server + SQLite, `cloud` for app.manifest.build |
+| `apiKey` | string | env `MANIFEST_API_KEY` | Agent API key (`mnfst_*`). Required for cloud mode only. |
+| `endpoint` | string | `https://app.manifest.build/otlp` | OTLP endpoint URL (cloud mode) |
 | `serviceName` | string | `openclaw-gateway` | OpenTelemetry service name |
-| `captureContent` | boolean | `false` | Include message content in spans |
-| `metricsIntervalMs` | number | `30000` | Metrics export interval (min 5000ms) |
+| `captureContent` | boolean | `false` | Include message content in spans. Always enabled in local mode. |
+| `metricsIntervalMs` | number | `30000` | Metrics export interval (min 5000ms). 10s in local mode. |
+| `port` | number | `2099` | Local server port (local mode only) |
+| `host` | string | `127.0.0.1` | Local server bind address (local mode only) |
 
 Point to a self-hosted instance:
 
@@ -110,15 +106,14 @@ Local testing:
 
 ```bash
 openclaw plugins install -l ./packages/openclaw-plugin
-openclaw config set plugins.entries.manifest.config.apiKey "mnfst_YOUR_KEY"
-openclaw config set plugins.entries.manifest.config.endpoint "http://localhost:3001/otlp/v1"
 openclaw gateway restart
+# Dashboard at http://127.0.0.1:2099
 ```
 
 ## Troubleshooting
 
 **No spans appearing?**
-- Check your API key starts with `mnfst_`
+- In cloud mode, check your API key starts with `mnfst_`
 - Verify the endpoint is reachable: `curl -I http://your-endpoint/v1/traces`
 - Disable `diagnostics-otel` if enabled: `openclaw plugins disable diagnostics-otel`
 

package/dist/backend/analytics/analytics.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AnalyticsModule {
+}

package/dist/backend/analytics/analytics.module.js

@@ -0,0 +1,45 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsModule = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const agent_message_entity_1 = require("../entities/agent-message.entity");
+const agent_entity_1 = require("../entities/agent.entity");
+const tenant_entity_1 = require("../entities/tenant.entity");
+const otlp_module_1 = require("../otlp/otlp.module");
+const aggregation_service_1 = require("./services/aggregation.service");
+const timeseries_queries_service_1 = require("./services/timeseries-queries.service");
+const agent_analytics_service_1 = require("./services/agent-analytics.service");
+const overview_controller_1 = require("./controllers/overview.controller");
+const tokens_controller_1 = require("./controllers/tokens.controller");
+const costs_controller_1 = require("./controllers/costs.controller");
+const messages_controller_1 = require("./controllers/messages.controller");
+const agents_controller_1 = require("./controllers/agents.controller");
+const agent_analytics_controller_1 = require("./controllers/agent-analytics.controller");
+let AnalyticsModule = class AnalyticsModule {
+};
+exports.AnalyticsModule = AnalyticsModule;
+exports.AnalyticsModule = AnalyticsModule = __decorate([
+    (0, common_1.Module)({
+        imports: [
+            typeorm_1.TypeOrmModule.forFeature([agent_message_entity_1.AgentMessage, agent_entity_1.Agent, tenant_entity_1.Tenant]),
+            otlp_module_1.OtlpModule,
+        ],
+        controllers: [
+            overview_controller_1.OverviewController,
+            tokens_controller_1.TokensController,
+            costs_controller_1.CostsController,
+            messages_controller_1.MessagesController,
+            agents_controller_1.AgentsController,
+            agent_analytics_controller_1.AgentAnalyticsController,
+        ],
+        providers: [aggregation_service_1.AggregationService, timeseries_queries_service_1.TimeseriesQueriesService, agent_analytics_service_1.AgentAnalyticsService],
+    })
+], AnalyticsModule);
+//# sourceMappingURL=analytics.module.js.map

package/dist/backend/analytics/analytics.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.module.js","sourceRoot":"","sources":["../../src/analytics/analytics.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,6CAAgD;AAChD,2EAAgE;AAChE,2DAAiD;AACjD,6DAAmD;AACnD,qDAAiD;AACjD,wEAAoE;AACpE,sFAAiF;AACjF,gFAA2E;AAC3E,2EAAuE;AACvE,uEAAmE;AACnE,qEAAiE;AACjE,2EAAuE;AACvE,uEAAmE;AACnE,yFAAoF;AAiB7E,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAf3B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,uBAAa,CAAC,UAAU,CAAC,CAAC,mCAAY,EAAE,oBAAK,EAAE,sBAAM,CAAC,CAAC;YACvD,wBAAU;SACX;QACD,WAAW,EAAE;YACX,wCAAkB;YAClB,oCAAgB;YAChB,kCAAe;YACf,wCAAkB;YAClB,oCAAgB;YAChB,qDAAwB;SACzB;QACD,SAAS,EAAE,CAAC,wCAAkB,EAAE,qDAAwB,EAAE,+CAAqB,CAAC;KACjF,CAAC;GACW,eAAe,CAAG"}

package/dist/backend/analytics/controllers/agent-analytics.controller.d.ts

@@ -0,0 +1,14 @@
+import { Request } from 'express';
+import { IngestionContext } from '../../otlp/interfaces/ingestion-context.interface';
+import { AgentAnalyticsService } from '../services/agent-analytics.service';
+import { RangeQueryDto } from '../../common/dto/range-query.dto';
+interface AuthenticatedRequest extends Request {
+    ingestionContext: IngestionContext;
+}
+export declare class AgentAnalyticsController {
+    private readonly analytics;
+    constructor(analytics: AgentAnalyticsService);
+    getUsage(query: RangeQueryDto, req: AuthenticatedRequest): Promise<import("../services/agent-analytics.service").AgentUsageResult>;
+    getCosts(query: RangeQueryDto, req: AuthenticatedRequest): Promise<import("../services/agent-analytics.service").AgentCostsResult>;
+}
+export {};

package/dist/backend/analytics/controllers/agent-analytics.controller.js

@@ -0,0 +1,60 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentAnalyticsController = void 0;
+const common_1 = require("@nestjs/common");
+const public_decorator_1 = require("../../common/decorators/public.decorator");
+const otlp_auth_guard_1 = require("../../otlp/guards/otlp-auth.guard");
+const agent_analytics_service_1 = require("../services/agent-analytics.service");
+const range_query_dto_1 = require("../../common/dto/range-query.dto");
+let AgentAnalyticsController = class AgentAnalyticsController {
+    analytics;
+    constructor(analytics) {
+        this.analytics = analytics;
+    }
+    async getUsage(query, req) {
+        const range = query.range ?? '24h';
+        const ctx = req.ingestionContext;
+        return this.analytics.getUsage(range, ctx);
+    }
+    async getCosts(query, req) {
+        const range = query.range ?? '7d';
+        const ctx = req.ingestionContext;
+        return this.analytics.getCosts(range, ctx);
+    }
+};
+exports.AgentAnalyticsController = AgentAnalyticsController;
+__decorate([
+    (0, common_1.Get)('usage'),
+    __param(0, (0, common_1.Query)()),
+    __param(1, (0, common_1.Req)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [range_query_dto_1.RangeQueryDto, Object]),
+    __metadata("design:returntype", Promise)
+], AgentAnalyticsController.prototype, "getUsage", null);
+__decorate([
+    (0, common_1.Get)('costs'),
+    __param(0, (0, common_1.Query)()),
+    __param(1, (0, common_1.Req)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [range_query_dto_1.RangeQueryDto, Object]),
+    __metadata("design:returntype", Promise)
+], AgentAnalyticsController.prototype, "getCosts", null);
+exports.AgentAnalyticsController = AgentAnalyticsController = __decorate([
+    (0, common_1.Controller)('api/v1/agent'),
+    (0, public_decorator_1.Public)(),
+    (0, common_1.UseGuards)(otlp_auth_guard_1.OtlpAuthGuard),
+    __metadata("design:paramtypes", [agent_analytics_service_1.AgentAnalyticsService])
+], AgentAnalyticsController);
+//# sourceMappingURL=agent-analytics.controller.js.map

package/dist/backend/analytics/controllers/agent-analytics.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-analytics.controller.js","sourceRoot":"","sources":["../../../src/analytics/controllers/agent-analytics.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwE;AAExE,+EAAkE;AAClE,uEAAkE;AAElE,iFAA4E;AAC5E,sEAAiE;AAS1D,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IACN;IAA7B,YAA6B,SAAgC;QAAhC,cAAS,GAAT,SAAS,CAAuB;IAAG,CAAC;IAG3D,AAAN,KAAK,CAAC,QAAQ,CACH,KAAoB,EACtB,GAAyB;QAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;QACnC,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAGK,AAAN,KAAK,CAAC,QAAQ,CACH,KAAoB,EACtB,GAAyB;QAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC;QAClC,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;CACF,CAAA;AAtBY,4DAAwB;AAI7B;IADL,IAAA,YAAG,EAAC,OAAO,CAAC;IAEV,WAAA,IAAA,cAAK,GAAE,CAAA;IACP,WAAA,IAAA,YAAG,GAAE,CAAA;;qCADU,+BAAa;;wDAM9B;AAGK;IADL,IAAA,YAAG,EAAC,OAAO,CAAC;IAEV,WAAA,IAAA,cAAK,GAAE,CAAA;IACP,WAAA,IAAA,YAAG,GAAE,CAAA;;qCADU,+BAAa;;wDAM9B;mCArBU,wBAAwB;IAHpC,IAAA,mBAAU,EAAC,cAAc,CAAC;IAC1B,IAAA,yBAAM,GAAE;IACR,IAAA,kBAAS,EAAC,+BAAa,CAAC;qCAEiB,+CAAqB;GADlD,wBAAwB,CAsBpC"}

package/dist/backend/analytics/controllers/agents.controller.d.ts

@@ -0,0 +1,40 @@
+import { ConfigService } from '@nestjs/config';
+import { TimeseriesQueriesService } from '../services/timeseries-queries.service';
+import { AggregationService } from '../services/aggregation.service';
+import { ApiKeyGeneratorService } from '../../otlp/services/api-key.service';
+import { AuthUser } from '../../auth/auth.instance';
+import { CreateAgentDto } from '../../common/dto/create-agent.dto';
+export declare class AgentsController {
+    private readonly timeseries;
+    private readonly aggregation;
+    private readonly apiKeyGenerator;
+    private readonly config;
+    constructor(timeseries: TimeseriesQueriesService, aggregation: AggregationService, apiKeyGenerator: ApiKeyGeneratorService, config: ConfigService);
+    getAgents(user: AuthUser): Promise<{
+        agents: {
+            agent_name: string;
+            message_count: number;
+            last_active: string;
+            total_cost: number;
+            total_tokens: number;
+            sparkline: number[];
+        }[];
+    }>;
+    createAgent(user: AuthUser, body: CreateAgentDto): Promise<{
+        agent: {
+            id: string;
+            name: string;
+        };
+        apiKey: string;
+    }>;
+    getAgentKey(user: AuthUser, agentName: string): Promise<{
+        pluginEndpoint?: string | undefined;
+        keyPrefix: string;
+    }>;
+    rotateAgentKey(user: AuthUser, agentName: string): Promise<{
+        apiKey: string;
+    }>;
+    deleteAgent(user: AuthUser, agentName: string): Promise<{
+        deleted: boolean;
+    }>;
+}

package/dist/backend/analytics/controllers/agents.controller.js

@@ -0,0 +1,115 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsController = void 0;
+const common_1 = require("@nestjs/common");
+const cache_manager_1 = require("@nestjs/cache-manager");
+const config_1 = require("@nestjs/config");
+const timeseries_queries_service_1 = require("../services/timeseries-queries.service");
+const aggregation_service_1 = require("../services/aggregation.service");
+const api_key_service_1 = require("../../otlp/services/api-key.service");
+const current_user_decorator_1 = require("../../auth/current-user.decorator");
+const create_agent_dto_1 = require("../../common/dto/create-agent.dto");
+const user_cache_interceptor_1 = require("../../common/interceptors/user-cache.interceptor");
+const cache_constants_1 = require("../../common/constants/cache.constants");
+let AgentsController = class AgentsController {
+    timeseries;
+    aggregation;
+    apiKeyGenerator;
+    config;
+    constructor(timeseries, aggregation, apiKeyGenerator, config) {
+        this.timeseries = timeseries;
+        this.aggregation = aggregation;
+        this.apiKeyGenerator = apiKeyGenerator;
+        this.config = config;
+    }
+    async getAgents(user) {
+        const agents = await this.timeseries.getAgentList(user.id);
+        return { agents };
+    }
+    async createAgent(user, body) {
+        const result = await this.apiKeyGenerator.onboardAgent({
+            tenantName: user.id,
+            agentName: body.name,
+            email: user.email,
+        });
+        return { agent: { id: result.agentId, name: body.name }, apiKey: result.apiKey };
+    }
+    async getAgentKey(user, agentName) {
+        const keyData = await this.apiKeyGenerator.getKeyForAgent(user.id, agentName);
+        const customEndpoint = this.config.get('app.pluginOtlpEndpoint', '');
+        return {
+            ...keyData,
+            ...(customEndpoint ? { pluginEndpoint: customEndpoint } : {}),
+        };
+    }
+    async rotateAgentKey(user, agentName) {
+        const result = await this.apiKeyGenerator.rotateKey(user.id, agentName);
+        return { apiKey: result.apiKey };
+    }
+    async deleteAgent(user, agentName) {
+        await this.aggregation.deleteAgent(user.id, agentName);
+        return { deleted: true };
+    }
+};
+exports.AgentsController = AgentsController;
+__decorate([
+    (0, common_1.Get)('agents'),
+    (0, common_1.UseInterceptors)(user_cache_interceptor_1.UserCacheInterceptor),
+    (0, cache_manager_1.CacheTTL)(cache_constants_1.DASHBOARD_CACHE_TTL_MS),
+    __param(0, (0, current_user_decorator_1.CurrentUser)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AgentsController.prototype, "getAgents", null);
+__decorate([
+    (0, common_1.Post)('agents'),
+    __param(0, (0, current_user_decorator_1.CurrentUser)()),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, create_agent_dto_1.CreateAgentDto]),
+    __metadata("design:returntype", Promise)
+], AgentsController.prototype, "createAgent", null);
+__decorate([
+    (0, common_1.Get)('agents/:agentName/key'),
+    __param(0, (0, current_user_decorator_1.CurrentUser)()),
+    __param(1, (0, common_1.Param)('agentName')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], AgentsController.prototype, "getAgentKey", null);
+__decorate([
+    (0, common_1.Post)('agents/:agentName/rotate-key'),
+    __param(0, (0, current_user_decorator_1.CurrentUser)()),
+    __param(1, (0, common_1.Param)('agentName')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], AgentsController.prototype, "rotateAgentKey", null);
+__decorate([
+    (0, common_1.Delete)('agents/:agentName'),
+    __param(0, (0, current_user_decorator_1.CurrentUser)()),
+    __param(1, (0, common_1.Param)('agentName')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], AgentsController.prototype, "deleteAgent", null);
+exports.AgentsController = AgentsController = __decorate([
+    (0, common_1.Controller)('api/v1'),
+    __metadata("design:paramtypes", [timeseries_queries_service_1.TimeseriesQueriesService,
+        aggregation_service_1.AggregationService,
+        api_key_service_1.ApiKeyGeneratorService,
+        config_1.ConfigService])
+], AgentsController);
+//# sourceMappingURL=agents.controller.js.map

package/dist/backend/analytics/controllers/agents.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.controller.js","sourceRoot":"","sources":["../../../src/analytics/controllers/agents.controller.ts"],"names":[],"mappings":"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"}

package/dist/backend/analytics/controllers/costs.controller.d.ts

@@ -0,0 +1,28 @@
+import { RangeQueryDto } from '../../common/dto/range-query.dto';
+import { AggregationService } from '../services/aggregation.service';
+import { TimeseriesQueriesService } from '../services/timeseries-queries.service';
+import { AuthUser } from '../../auth/auth.instance';
+export declare class CostsController {
+    private readonly aggregation;
+    private readonly timeseries;
+    constructor(aggregation: AggregationService, timeseries: TimeseriesQueriesService);
+    getCosts(query: RangeQueryDto, user: AuthUser): Promise<{
+        summary: {
+            weekly_cost: import("../services/query-helpers").MetricWithTrend;
+        };
+        daily: {
+            date: string;
+            cost: number;
+        }[];
+        hourly: {
+            hour: string;
+            cost: number;
+        }[];
+        by_model: {
+            model: string;
+            tokens: number;
+            share_pct: number;
+            estimated_cost: number;
+        }[];
+    }>;
+}

package/dist/backend/analytics/controllers/costs.controller.js

@@ -0,0 +1,64 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CostsController = void 0;
+const common_1 = require("@nestjs/common");
+const cache_manager_1 = require("@nestjs/cache-manager");
+const range_query_dto_1 = require("../../common/dto/range-query.dto");
+const aggregation_service_1 = require("../services/aggregation.service");
+const timeseries_queries_service_1 = require("../services/timeseries-queries.service");
+const current_user_decorator_1 = require("../../auth/current-user.decorator");
+const user_cache_interceptor_1 = require("../../common/interceptors/user-cache.interceptor");
+const cache_constants_1 = require("../../common/constants/cache.constants");
+let CostsController = class CostsController {
+    aggregation;
+    timeseries;
+    constructor(aggregation, timeseries) {
+        this.aggregation = aggregation;
+        this.timeseries = timeseries;
+    }
+    async getCosts(query, user) {
+        const range = query.range ?? '7d';
+        const agentName = query.agent_name;
+        const [costSummary, daily, hourly, byModel] = await Promise.all([
+            this.aggregation.getCostSummary(range, user.id, agentName),
+            this.timeseries.getDailyCosts(range, user.id, agentName),
+            this.timeseries.getHourlyCosts(range, user.id, agentName),
+            this.timeseries.getCostByModel(range, user.id, agentName),
+        ]);
+        return {
+            summary: { weekly_cost: costSummary },
+            daily,
+            hourly,
+            by_model: byModel,
+        };
+    }
+};
+exports.CostsController = CostsController;
+__decorate([
+    (0, common_1.Get)('costs'),
+    __param(0, (0, common_1.Query)()),
+    __param(1, (0, current_user_decorator_1.CurrentUser)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [range_query_dto_1.RangeQueryDto, Object]),
+    __metadata("design:returntype", Promise)
+], CostsController.prototype, "getCosts", null);
+exports.CostsController = CostsController = __decorate([
+    (0, common_1.Controller)('api/v1'),
+    (0, common_1.UseInterceptors)(user_cache_interceptor_1.UserCacheInterceptor),
+    (0, cache_manager_1.CacheTTL)(cache_constants_1.DASHBOARD_CACHE_TTL_MS),
+    __metadata("design:paramtypes", [aggregation_service_1.AggregationService,
+        timeseries_queries_service_1.TimeseriesQueriesService])
+], CostsController);
+//# sourceMappingURL=costs.controller.js.map

package/dist/backend/analytics/controllers/costs.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costs.controller.js","sourceRoot":"","sources":["../../../src/analytics/controllers/costs.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAyE;AACzE,yDAAiD;AACjD,sEAAiE;AACjE,yEAAqE;AACrE,uFAAkF;AAClF,8EAAgE;AAEhE,6FAAwF;AACxF,4EAAgF;AAKzE,IAAM,eAAe,GAArB,MAAM,eAAe;IAEP;IACA;IAFnB,YACmB,WAA+B,EAC/B,UAAoC;QADpC,gBAAW,GAAX,WAAW,CAAoB;QAC/B,eAAU,GAAV,UAAU,CAA0B;IACpD,CAAC;IAGE,AAAN,KAAK,CAAC,QAAQ,CAAU,KAAoB,EAAiB,IAAc;QACzE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC;QAEnC,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9D,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC;YAC1D,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC;YACxD,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC;YACzD,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC;SAC1D,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE;YACrC,KAAK;YACL,MAAM;YACN,QAAQ,EAAE,OAAO;SAClB,CAAC;IACJ,CAAC;CACF,CAAA;AAzBY,0CAAe;AAOpB;IADL,IAAA,YAAG,EAAC,OAAO,CAAC;IACG,WAAA,IAAA,cAAK,GAAE,CAAA;IAAwB,WAAA,IAAA,oCAAW,GAAE,CAAA;;qCAA7B,+BAAa;;+CAiB3C;0BAxBU,eAAe;IAH3B,IAAA,mBAAU,EAAC,QAAQ,CAAC;IACpB,IAAA,wBAAe,EAAC,6CAAoB,CAAC;IACrC,IAAA,wBAAQ,EAAC,wCAAsB,CAAC;qCAGC,wCAAkB;QACnB,qDAAwB;GAH5C,eAAe,CAyB3B"}

package/dist/backend/analytics/controllers/messages.controller.d.ts

@@ -0,0 +1,13 @@
+import { MessagesQueryDto } from '../dto/messages-query.dto';
+import { AggregationService } from '../services/aggregation.service';
+import { AuthUser } from '../../auth/auth.instance';
+export declare class MessagesController {
+    private readonly aggregation;
+    constructor(aggregation: AggregationService);
+    getMessages(query: MessagesQueryDto, user: AuthUser): Promise<{
+        items: any[];
+        next_cursor: string | null;
+        total_count: number;
+        models: string[];
+    }>;
+}

package/dist/backend/analytics/controllers/messages.controller.js

@@ -0,0 +1,53 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagesController = void 0;
+const common_1 = require("@nestjs/common");
+const messages_query_dto_1 = require("../dto/messages-query.dto");
+const aggregation_service_1 = require("../services/aggregation.service");
+const current_user_decorator_1 = require("../../auth/current-user.decorator");
+let MessagesController = class MessagesController {
+    aggregation;
+    constructor(aggregation) {
+        this.aggregation = aggregation;
+    }
+    async getMessages(query, user) {
+        return this.aggregation.getMessages({
+            range: query.range,
+            userId: user.id,
+            status: query.status,
+            service_type: query.service_type,
+            model: query.model,
+            cost_min: query.cost_min,
+            cost_max: query.cost_max,
+            limit: Math.min(query.limit ?? 50, 200),
+            cursor: query.cursor,
+            agent_name: query.agent_name,
+        });
+    }
+};
+exports.MessagesController = MessagesController;
+__decorate([
+    (0, common_1.Get)('messages'),
+    __param(0, (0, common_1.Query)()),
+    __param(1, (0, current_user_decorator_1.CurrentUser)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [messages_query_dto_1.MessagesQueryDto, Object]),
+    __metadata("design:returntype", Promise)
+], MessagesController.prototype, "getMessages", null);
+exports.MessagesController = MessagesController = __decorate([
+    (0, common_1.Controller)('api/v1'),
+    __metadata("design:paramtypes", [aggregation_service_1.AggregationService])
+], MessagesController);
+//# sourceMappingURL=messages.controller.js.map

package/dist/backend/analytics/controllers/messages.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.controller.js","sourceRoot":"","sources":["../../../src/analytics/controllers/messages.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwD;AACxD,kEAA6D;AAC7D,yEAAqE;AACrE,8EAAgE;AAIzD,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IACA;IAA7B,YAA6B,WAA+B;QAA/B,gBAAW,GAAX,WAAW,CAAoB;IAAG,CAAC;IAG1D,AAAN,KAAK,CAAC,WAAW,CAAU,KAAuB,EAAiB,IAAc;QAC/E,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;YAClC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC;YACvC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAlBY,gDAAkB;AAIvB;IADL,IAAA,YAAG,EAAC,UAAU,CAAC;IACG,WAAA,IAAA,cAAK,GAAE,CAAA;IAA2B,WAAA,IAAA,oCAAW,GAAE,CAAA;;qCAAhC,qCAAgB;;qDAajD;6BAjBU,kBAAkB;IAD9B,IAAA,mBAAU,EAAC,QAAQ,CAAC;qCAEuB,wCAAkB;GADjD,kBAAkB,CAkB9B"}

package/dist/backend/analytics/controllers/overview.controller.d.ts

@@ -0,0 +1,59 @@
+import { RangeQueryDto } from '../../common/dto/range-query.dto';
+import { AggregationService } from '../services/aggregation.service';
+import { TimeseriesQueriesService } from '../services/timeseries-queries.service';
+import { AuthUser } from '../../auth/auth.instance';
+export declare class OverviewController {
+    private readonly aggregation;
+    private readonly timeseries;
+    constructor(aggregation: AggregationService, timeseries: TimeseriesQueriesService);
+    getOverview(query: RangeQueryDto, user: AuthUser): Promise<{
+        summary: {
+            tokens_today: import("../services/query-helpers").MetricWithTrend;
+            cost_today: import("../services/query-helpers").MetricWithTrend;
+            messages: import("../services/query-helpers").MetricWithTrend;
+            services_hit: {
+                total: number;
+                healthy: number;
+                issues: number;
+            };
+        };
+        token_usage: {
+            hour: string;
+            input_tokens: number;
+            output_tokens: number;
+        }[] | {
+            date: string;
+            input_tokens: number;
+            output_tokens: number;
+        }[];
+        cost_usage: {
+            hour: string;
+            cost: number;
+        }[] | {
+            date: string;
+            cost: number;
+        }[];
+        message_usage: {
+            hour: string;
+            count: number;
+        }[] | {
+            date: string;
+            count: number;
+        }[];
+        cost_by_model: {
+            model: string;
+            tokens: number;
+            share_pct: number;
+            estimated_cost: number;
+        }[];
+        recent_activity: any[];
+        active_skills: {
+            name: string;
+            agent_name: string | null;
+            run_count: number;
+            last_active_at: string;
+            status: "active";
+        }[];
+        has_data: boolean;
+    }>;
+}