@atolis-hq/wake 0.4.56 → 0.4.58

package/dist/src/orchestration/index.d.ts

@@ -27,3 +27,4 @@ export * from './domain/compiler.js';
 export * from './domain/interpreter.js';
 export * from './domain/workflow-instance.js';
 export * from './domain/workflow-selector.js';
+export * from './application/work-completion-summary.js';

package/dist/src/orchestration/index.js

@@ -27,3 +27,4 @@ export * from './domain/compiler.js';
 export * from './domain/interpreter.js';
 export * from './domain/workflow-instance.js';
 export * from './domain/workflow-selector.js';
+export * from './application/work-completion-summary.js';

package/dist/src/surfaces/api/contracts/observability.d.ts

@@ -1,3 +1,4 @@
+import type { ReportWindow } from '../../../kernel/index.js';
 export interface AnalyticsWindowResponse {
     readonly days: number;
     readonly from: string;
@@ -8,3 +9,17 @@ export interface MetricsResponse {
     readonly window: AnalyticsWindowResponse;
     readonly values: Readonly<Record<string, number>>;
 }
+export { ReportWindowId } from '../../../kernel/index.js';
+export type { ReportWindowId as AnalyticsReportWindowId, ReportDescriptor, ReportWindow, TimeSeriesReport, } from '../../../kernel/index.js';
+export interface AnalyticsSummaryResponse {
+    readonly window: ReportWindow;
+    readonly runs: number;
+    readonly completed: number;
+    readonly blockedOrAwaitingApproval: number;
+    readonly failed: number;
+    readonly totalTokens: number;
+    readonly totalCostUsd: number;
+    readonly medianRunDurationMs: number | null;
+    readonly workItemsDone: number;
+    readonly medianEndToEndDurationMs: number | null;
+}

package/dist/src/surfaces/api/contracts/observability.js

@@ -1 +1 @@
-export {};
+export { ReportWindowId } from '../../../kernel/index.js';

package/dist/src/surfaces/api/http-server.d.ts

@@ -14,7 +14,7 @@ export interface ApiHttpResponse {
 }
 /** A transport-only dispatcher supplied by Bootstrap composition. */
 export interface ApiDispatcher {
-    dispatch(method: string, pathname: string, body: unknown): Promise<ApiHttpResponse | undefined>;
+    dispatch(method: string, pathname: string, body: unknown, signal?: AbortSignal): Promise<ApiHttpResponse | undefined>;
 }
 export interface SurfaceHttpServerOptions {
     readonly dispatcher: ApiDispatcher;

package/dist/src/surfaces/api/http-server.js

@@ -81,7 +81,29 @@ export function createSurfaceHttpServer(options) {
                 return reply.code(401).send({ status: 401, title: 'Unauthorized' });
         });
         protectedApi.all('/*', async (request, reply) => {
-            const result = await options.dispatcher.dispatch(request.method, request.raw.url ?? request.url, request.body);
+            const controller = new AbortController();
+            const abort = () => controller.abort();
+            const close = () => {
+                if (!reply.raw.writableFinished)
+                    abort();
+            };
+            request.raw.once('aborted', abort);
+            reply.raw.once('close', close);
+            let result;
+            try {
+                result = await options.dispatcher.dispatch(request.method, request.raw.url ?? request.url, request.body, controller.signal);
+            }
+            catch (error) {
+                if (controller.signal.aborted)
+                    return reply;
+                throw error;
+            }
+            finally {
+                request.raw.off('aborted', abort);
+                reply.raw.off('close', close);
+            }
+            if (controller.signal.aborted)
+                return reply;
             if (result === undefined)
                 return sendFastifyJson(reply, {
                     status: 404,

package/dist/src/surfaces/api/routes/applications.d.ts

@@ -1,5 +1,7 @@
 import type { RunStatus } from '../../../execution/index.js';
+import type { ReportDescriptor, ReportWindowId, TimeSeriesReport } from '../../../kernel/index.js';
 import type { ApiCommandResult, AuditEventResponse, BoardCardResponse, BoardResponse, CommandsResponse, ConfigurationResponse, ControlPlaneStatusResponse, ConversationMessageRequest, HealthResponse, MetricsResponse, ResourceItemResponse, ResourceResponse, ResponseMeta, RunnerResponse, RunResponse, RunTranscriptResponse, StatusResponse, WebhookSetupResponse, WorkDetailResponse, WorkflowDiagramsResponse, WorkflowInstanceResponse, WorkItemResponse, WorkItemTranscriptResponse } from '../contracts/index.js';
+import type { AnalyticsSummaryResponse } from '../contracts/observability.js';
 export interface CollectionQuery {
     readonly cursor?: {
         readonly position: number;
@@ -90,6 +92,11 @@ export interface ApiApplications {
         list(query: CollectionQuery): Promise<ApiCollectionPage<AuditEventResponse>>;
     };
     readonly observability: {
+        readonly reports?: {
+            catalogue(): readonly ReportDescriptor[];
+            report(id: string, window: ReportWindowId, signal?: AbortSignal): Promise<ApiResourceResult<TimeSeriesReport>>;
+            summary(window: ReportWindowId, signal?: AbortSignal): Promise<ApiResourceResult<AnalyticsSummaryResponse>>;
+        };
         metrics(query?: {
             readonly days: number;
         }): Promise<ApiResourceResult<MetricsResponse>>;

package/dist/src/surfaces/api/routes/index.js

@@ -3,11 +3,11 @@ import { dispatchRead } from './read.js';
 import { problem } from './responses.js';
 export function createApiDispatcher(applications) {
     return {
-        async dispatch(method, target, body) {
+        async dispatch(method, target, body, signal) {
             const url = new URL(target, 'http://wake.local');
             if (!url.pathname.startsWith('/api/'))
                 return undefined;
-            const response = await dispatchRead(applications, method, url);
+            const response = await dispatchRead(applications, method, url, signal);
             if (response !== undefined)
                 return response;
             if (method === 'POST')

package/dist/src/surfaces/api/routes/observability.d.ts

@@ -1 +1 @@
-export declare const observabilityRoutes: readonly ["/api/v1/observability/metrics"];
+export declare const observabilityRoutes: readonly ["/api/v1/observability/metrics", "/api/v1/observability/reports", "/api/v1/observability/summary"];

package/dist/src/surfaces/api/routes/observability.js

@@ -1 +1,5 @@
-export const observabilityRoutes = ['/api/v1/observability/metrics'];
+export const observabilityRoutes = [
+    '/api/v1/observability/metrics',
+    '/api/v1/observability/reports',
+    '/api/v1/observability/summary',
+];

package/dist/src/surfaces/api/routes/read.d.ts

@@ -1,3 +1,3 @@
 import type { ApiHttpResponse } from '../http-server.js';
 import type { ApiApplications } from './applications.js';
-export declare function dispatchRead(applications: ApiApplications, method: string, url: URL): Promise<ApiHttpResponse | undefined>;
+export declare function dispatchRead(applications: ApiApplications, method: string, url: URL, signal?: AbortSignal): Promise<ApiHttpResponse | undefined>;

package/dist/src/surfaces/api/routes/read.js

@@ -1,3 +1,4 @@
+import { ReportWindowId } from '../../../kernel/index.js';
 import { collection, parseCollectionQuery } from './pagination.js';
 import { ApiPathError, decodePathSegment, found, invalidPath, invalidQuery, noQuery, ok, unavailable, } from './responses.js';
 const collectionRoutes = new Map([
@@ -9,9 +10,12 @@ const collectionRoutes = new Map([
     ['/api/v1/events', new Set(['cursor', 'limit', 'workItemKey'])],
     ['/api/v1/board', new Set(['cursor', 'limit'])],
 ]);
-export async function dispatchRead(applications, method, url) {
+export async function dispatchRead(applications, method, url, signal) {
     if (method !== 'GET' && method !== 'HEAD')
         return undefined;
+    if (url.pathname === '/api/v1/observability/reports' ||
+        url.pathname === '/api/v1/observability/summary')
+        return readReports(applications, url, signal);
     const resource = await readSingleton(applications, url);
     if (resource !== undefined)
         return resource;
@@ -182,3 +186,26 @@ async function readRun(applications, segment) {
         ? invalidPath(runId.message)
         : found(await applications.execution.get?.(runId));
 }
+async function readReports(applications, url, signal) {
+    const reports = applications.observability.reports;
+    if (reports === undefined)
+        return unavailable('reports');
+    const summary = url.pathname.endsWith('/summary');
+    const allowed = new Set(summary ? ['window'] : ['window', 'report']);
+    for (const key of url.searchParams.keys()) {
+        if (!allowed.has(key) || url.searchParams.getAll(key).length !== 1)
+            return invalidQuery(`Unknown or repeated query parameter: ${key}`, key);
+    }
+    if (!summary && url.search === '')
+        return ok({ data: reports.catalogue(), meta: { asOf: applications.now() } });
+    const raw = url.searchParams.get('window');
+    const window = Object.values(ReportWindowId).find((id) => id === raw);
+    if (window === undefined)
+        return invalidQuery('window must be 1d, 3d, 5d or 7d', 'window');
+    if (summary)
+        return ok(await reports.summary(window, signal));
+    const report = url.searchParams.get('report');
+    if (report === null || !reports.catalogue().some(({ id }) => id === report))
+        return invalidQuery('Unknown report identifier', 'report');
+    return ok(await reports.report(report, window, signal));
+}