@squadrules/mcp 4.8.6

package/dist/services/metrics/export-metrics.js

@@ -0,0 +1,50 @@
+import { Counter, Histogram } from 'prom-client';
+import { register } from './registry.js';
+/**
+ * Export path observability (HTTP + MCP both call {@link executeExport}).
+ * Use dashboards/alerts on duration and ZIP size to spot Qdrant/assemble/zip bottlenecks.
+ */
+export const exportDurationSeconds = new Histogram({
+    name: 'kairos_export_duration_seconds',
+    help: 'Wall-clock time for executeExport (storage reads, assemble, zip, encode)',
+    labelNames: ['format', 'status'],
+    buckets: [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30, 60, 120],
+    registers: [register]
+});
+export const exportRequestsTotal = new Counter({
+    name: 'kairos_export_requests_total',
+    help: 'Export invocations by format and outcome',
+    labelNames: ['format', 'status'],
+    registers: [register]
+});
+export const exportAdapterCount = new Histogram({
+    name: 'kairos_export_adapter_count',
+    help: 'Adapters included in export (skill_tree, skill_zip, or item_count for others)',
+    labelNames: ['format'],
+    buckets: [1, 2, 3, 5, 10, 25, 50, 100, 256],
+    registers: [register]
+});
+/** Decoded application/zip byte length before base64 (skill_zip only). */
+export const exportSkillZipDecodedBytes = new Histogram({
+    name: 'kairos_export_skill_zip_decoded_bytes',
+    help: 'Decoded ZIP size for skill_zip exports',
+    labelNames: [],
+    buckets: [
+        10_000, 50_000, 100_000, 250_000, 500_000, 1_000_000, 2_500_000, 5_000_000, 10_000_000, 50_000_000
+    ],
+    registers: [register]
+});
+export function hrtimeSecondsSince(start) {
+    return Number(process.hrtime.bigint() - start) / 1e9;
+}
+export function recordExportMetrics(opts) {
+    exportDurationSeconds.observe({ format: opts.format, status: opts.status }, opts.durationSec);
+    exportRequestsTotal.inc({ format: opts.format, status: opts.status });
+    if (opts.status === 'success' && opts.adapterCount != null && opts.adapterCount >= 0) {
+        exportAdapterCount.observe({ format: opts.format }, opts.adapterCount);
+    }
+    if (opts.skillZipDecodedBytes != null && opts.skillZipDecodedBytes >= 0) {
+        exportSkillZipDecodedBytes.observe(opts.skillZipDecodedBytes);
+    }
+}
+//# sourceMappingURL=export-metrics.js.map

package/dist/services/metrics/export-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-metrics.js","sourceRoot":"","sources":["../../../src/services/metrics/export-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;GAGG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,SAAS,CAAC;IACjD,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,0EAA0E;IAChF,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAChC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC;IACjE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,OAAO,CAAC;IAC7C,IAAI,EAAE,8BAA8B;IACpC,IAAI,EAAE,0CAA0C;IAChD,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAChC,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,SAAS,CAAC;IAC9C,IAAI,EAAE,6BAA6B;IACnC,IAAI,EAAE,+EAA+E;IACrF,UAAU,EAAE,CAAC,QAAQ,CAAC;IACtB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC;IAC3C,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,SAAS,CAAC;IACtD,IAAI,EAAE,uCAAuC;IAC7C,IAAI,EAAE,wCAAwC;IAC9C,UAAU,EAAE,EAAE;IACd,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU;KACnG;IACD,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAQnC;IACC,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9F,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC;QACrF,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,CAAC,oBAAoB,IAAI,IAAI,IAAI,IAAI,CAAC,oBAAoB,IAAI,CAAC,EAAE,CAAC;QACxE,0BAA0B,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/services/metrics/http-metrics.d.ts

@@ -0,0 +1,12 @@
+import { Counter, Histogram, Gauge } from 'prom-client';
+/**
+ * HTTP Server Metrics
+ *
+ * Tracks HTTP requests, response times, and payload sizes.
+ */
+export declare const httpRequests: Counter<"status" | "method" | "tenant_id" | "route">;
+export declare const httpRequestDuration: Histogram<"status" | "method" | "tenant_id" | "route">;
+export declare const httpRequestSize: Histogram<"method" | "tenant_id" | "route">;
+export declare const httpResponseSize: Histogram<"status" | "method" | "tenant_id" | "route">;
+export declare const httpActiveConnections: Gauge<"tenant_id">;
+//# sourceMappingURL=http-metrics.d.ts.map

package/dist/services/metrics/http-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-metrics.d.ts","sourceRoot":"","sources":["../../../src/services/metrics/http-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIxD;;;;GAIG;AAEH,eAAO,MAAM,YAAY,sDAKvB,CAAC;AAEH,eAAO,MAAM,mBAAmB,wDAM9B,CAAC;AAEH,eAAO,MAAM,eAAe,6CAM1B,CAAC;AAEH,eAAO,MAAM,gBAAgB,wDAM3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,oBAKhC,CAAC"}

package/dist/services/metrics/http-metrics.js

@@ -0,0 +1,41 @@
+import { Counter, Histogram, Gauge } from 'prom-client';
+import { register } from './registry.js';
+/**
+ * HTTP Server Metrics
+ *
+ * Tracks HTTP requests, response times, and payload sizes.
+ */
+export const httpRequests = new Counter({
+    name: 'kairos_http_requests_total',
+    help: 'Total number of HTTP requests',
+    labelNames: ['method', 'route', 'status', 'tenant_id'],
+    registers: [register]
+});
+export const httpRequestDuration = new Histogram({
+    name: 'kairos_http_request_duration_seconds',
+    help: 'HTTP request duration in seconds',
+    labelNames: ['method', 'route', 'status', 'tenant_id'],
+    buckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],
+    registers: [register]
+});
+export const httpRequestSize = new Histogram({
+    name: 'kairos_http_request_size_bytes',
+    help: 'HTTP request payload size in bytes',
+    labelNames: ['method', 'route', 'tenant_id'],
+    buckets: [100, 500, 1000, 5000, 10000, 50000, 100000, 500000, 1000000],
+    registers: [register]
+});
+export const httpResponseSize = new Histogram({
+    name: 'kairos_http_response_size_bytes',
+    help: 'HTTP response payload size in bytes',
+    labelNames: ['method', 'route', 'status', 'tenant_id'],
+    buckets: [100, 500, 1000, 5000, 10000, 50000, 100000, 500000, 1000000],
+    registers: [register]
+});
+export const httpActiveConnections = new Gauge({
+    name: 'kairos_http_active_connections',
+    help: 'Current number of active HTTP connections',
+    labelNames: ['tenant_id'],
+    registers: [register]
+});
+//# sourceMappingURL=http-metrics.js.map

package/dist/services/metrics/http-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-metrics.js","sourceRoot":"","sources":["../../../src/services/metrics/http-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC;IACtC,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,+BAA+B;IACrC,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;IACtD,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,SAAS,CAAC;IAC/C,IAAI,EAAE,sCAAsC;IAC5C,IAAI,EAAE,kCAAkC;IACxC,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;IACtD,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IACzE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,SAAS,CAAC;IAC3C,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,oCAAoC;IAC1C,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC;IAC5C,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;IACtE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,SAAS,CAAC;IAC5C,IAAI,EAAE,iCAAiC;IACvC,IAAI,EAAE,qCAAqC;IAC3C,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;IACtD,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;IACtE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,KAAK,CAAC;IAC7C,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,2CAA2C;IACjD,UAAU,EAAE,CAAC,WAAW,CAAC;IACzB,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC"}

package/dist/services/metrics/mcp-metrics.d.ts

@@ -0,0 +1,16 @@
+import { Counter, Histogram } from 'prom-client';
+/**
+ * MCP Tool Metrics
+ *
+ * Tracks all kairos_* tool invocations, duration, errors, and payload sizes.
+ */
+export declare const mcpToolCalls: Counter<"status" | "tool" | "tenant_id">;
+export declare const mcpToolDuration: Histogram<"status" | "tool" | "tenant_id">;
+export declare const mcpToolErrors: Counter<"status" | "tool" | "tenant_id">;
+export declare const mcpToolInputSize: Histogram<"tool" | "tenant_id">;
+export declare const mcpToolOutputSize: Histogram<"tool" | "tenant_id">;
+/** Incremented when forward quality update (quality_metadata/metrics) fails. */
+export declare const kairosQualityUpdateErrors: Counter<"tenant_id">;
+/** Incremented when train returns SIMILAR_MEMORY_FOUND (MCP or HTTP). */
+export declare const kairosTrainSimilarAdapterFound: Counter<"tenant_id" | "transport">;
+//# sourceMappingURL=mcp-metrics.d.ts.map

package/dist/services/metrics/mcp-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-metrics.d.ts","sourceRoot":"","sources":["../../../src/services/metrics/mcp-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;GAIG;AAEH,eAAO,MAAM,YAAY,0CAKvB,CAAC;AAEH,eAAO,MAAM,eAAe,4CAM1B,CAAC;AAEH,eAAO,MAAM,aAAa,0CAKxB,CAAC;AAEH,eAAO,MAAM,gBAAgB,iCAM3B,CAAC;AAEH,eAAO,MAAM,iBAAiB,iCAM5B,CAAC;AAEH,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,sBAKpC,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,oCAKzC,CAAC"}

package/dist/services/metrics/mcp-metrics.js

@@ -0,0 +1,55 @@
+import { Counter, Histogram } from 'prom-client';
+import { register } from './registry.js';
+/**
+ * MCP Tool Metrics
+ *
+ * Tracks all kairos_* tool invocations, duration, errors, and payload sizes.
+ */
+export const mcpToolCalls = new Counter({
+    name: 'kairos_mcp_tool_calls_total',
+    help: 'Total number of MCP tool invocations',
+    labelNames: ['tool', 'status', 'tenant_id'],
+    registers: [register]
+});
+export const mcpToolDuration = new Histogram({
+    name: 'kairos_mcp_tool_duration_seconds',
+    help: 'MCP tool execution duration in seconds',
+    labelNames: ['tool', 'status', 'tenant_id'],
+    buckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],
+    registers: [register]
+});
+export const mcpToolErrors = new Counter({
+    name: 'kairos_mcp_tool_errors_total',
+    help: 'Total number of MCP tool execution errors',
+    labelNames: ['tool', 'status', 'tenant_id'],
+    registers: [register]
+});
+export const mcpToolInputSize = new Histogram({
+    name: 'kairos_mcp_tool_input_size_bytes',
+    help: 'MCP tool input payload size in bytes',
+    labelNames: ['tool', 'tenant_id'],
+    buckets: [100, 500, 1000, 5000, 10000, 50000, 100000, 500000, 1000000],
+    registers: [register]
+});
+export const mcpToolOutputSize = new Histogram({
+    name: 'kairos_mcp_tool_output_size_bytes',
+    help: 'MCP tool output payload size in bytes',
+    labelNames: ['tool', 'tenant_id'],
+    buckets: [100, 500, 1000, 5000, 10000, 50000, 100000, 500000, 1000000],
+    registers: [register]
+});
+/** Incremented when forward quality update (quality_metadata/metrics) fails. */
+export const kairosQualityUpdateErrors = new Counter({
+    name: 'kairos_quality_update_errors_total',
+    help: 'Quality update failures in forward (log-and-continue path)',
+    labelNames: ['tenant_id'],
+    registers: [register]
+});
+/** Incremented when train returns SIMILAR_MEMORY_FOUND (MCP or HTTP). */
+export const kairosTrainSimilarAdapterFound = new Counter({
+    name: 'kairos_train_similar_adapter_found_total',
+    help: 'Times train returned SIMILAR_MEMORY_FOUND (agent must inspect the similar adapter before deciding)',
+    labelNames: ['transport', 'tenant_id'],
+    registers: [register]
+});
+//# sourceMappingURL=mcp-metrics.js.map

package/dist/services/metrics/mcp-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-metrics.js","sourceRoot":"","sources":["../../../src/services/metrics/mcp-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC;IACtC,IAAI,EAAE,6BAA6B;IACnC,IAAI,EAAE,sCAAsC;IAC5C,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC;IAC3C,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,SAAS,CAAC;IAC3C,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,wCAAwC;IAC9C,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IACzE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC;IACvC,IAAI,EAAE,8BAA8B;IACpC,IAAI,EAAE,2CAA2C;IACjD,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC;IAC3C,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,SAAS,CAAC;IAC5C,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,sCAAsC;IAC5C,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IACjC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;IACtE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,SAAS,CAAC;IAC7C,IAAI,EAAE,mCAAmC;IACzC,IAAI,EAAE,uCAAuC;IAC7C,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IACjC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;IACtE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,OAAO,CAAC;IACnD,IAAI,EAAE,oCAAoC;IAC1C,IAAI,EAAE,4DAA4D;IAClE,UAAU,EAAE,CAAC,WAAW,CAAC;IACzB,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,OAAO,CAAC;IACxD,IAAI,EAAE,0CAA0C;IAChD,IAAI,EAAE,oGAAoG;IAC1G,UAAU,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;IACtC,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC"}

package/dist/services/metrics/memory-metrics.d.ts

@@ -0,0 +1,10 @@
+import { Counter, Histogram } from 'prom-client';
+/**
+ * Memory Operation Metrics
+ *
+ * Tracks memory store, retrieve, search, update, and delete operations.
+ */
+export declare const memoryStore: Counter<"tenant_id" | "quality">;
+export declare const memoryStoreDuration: Histogram<"tenant_id" | "quality">;
+export declare const memoryAdapterSize: Histogram<"tenant_id">;
+//# sourceMappingURL=memory-metrics.d.ts.map

package/dist/services/metrics/memory-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-metrics.d.ts","sourceRoot":"","sources":["../../../src/services/metrics/memory-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;GAIG;AAEH,eAAO,MAAM,WAAW,kCAKtB,CAAC;AAEH,eAAO,MAAM,mBAAmB,oCAM9B,CAAC;AAEH,eAAO,MAAM,iBAAiB,wBAM5B,CAAC"}

package/dist/services/metrics/memory-metrics.js

@@ -0,0 +1,28 @@
+import { Counter, Histogram } from 'prom-client';
+import { register } from './registry.js';
+/**
+ * Memory Operation Metrics
+ *
+ * Tracks memory store, retrieve, search, update, and delete operations.
+ */
+export const memoryStore = new Counter({
+    name: 'kairos_memory_store_total',
+    help: 'Total number of memories stored',
+    labelNames: ['quality', 'tenant_id'],
+    registers: [register]
+});
+export const memoryStoreDuration = new Histogram({
+    name: 'kairos_memory_store_duration_seconds',
+    help: 'Memory storage operation duration in seconds',
+    labelNames: ['quality', 'tenant_id'],
+    buckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],
+    registers: [register]
+});
+export const memoryAdapterSize = new Histogram({
+    name: 'kairos_memory_adapter_size',
+    help: 'Number of layers in stored adapters',
+    labelNames: ['tenant_id'],
+    buckets: [1, 2, 3, 4, 5, 10, 15, 20, 25, 50],
+    registers: [register]
+});
+//# sourceMappingURL=memory-metrics.js.map

package/dist/services/metrics/memory-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-metrics.js","sourceRoot":"","sources":["../../../src/services/metrics/memory-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;;GAIG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC;IACrC,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,iCAAiC;IACvC,UAAU,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;IACpC,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,SAAS,CAAC;IAC/C,IAAI,EAAE,sCAAsC;IAC5C,IAAI,EAAE,8CAA8C;IACpD,UAAU,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IACzE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,SAAS,CAAC;IAC7C,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,qCAAqC;IAC3C,UAAU,EAAE,CAAC,WAAW,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAC5C,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC"}

package/dist/services/metrics/qdrant-metrics.d.ts

@@ -0,0 +1,11 @@
+import { Counter, Histogram } from 'prom-client';
+/**
+ * Qdrant Vector Database Metrics
+ *
+ * Tracks Qdrant operations, connection status, and performance.
+ */
+export declare const qdrantOperations: Counter<"status" | "operation" | "tenant_id">;
+export declare const qdrantOperationDuration: Histogram<"operation" | "tenant_id">;
+export declare const qdrantQueryDuration: Histogram<"tenant_id">;
+export declare const qdrantUpsertDuration: Histogram<"tenant_id">;
+//# sourceMappingURL=qdrant-metrics.d.ts.map

package/dist/services/metrics/qdrant-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-metrics.d.ts","sourceRoot":"","sources":["../../../src/services/metrics/qdrant-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;GAIG;AAEH,eAAO,MAAM,gBAAgB,+CAK3B,CAAC;AAEH,eAAO,MAAM,uBAAuB,sCAMlC,CAAC;AAEH,eAAO,MAAM,mBAAmB,wBAM9B,CAAC;AAEH,eAAO,MAAM,oBAAoB,wBAM/B,CAAC"}

package/dist/services/metrics/qdrant-metrics.js

@@ -0,0 +1,35 @@
+import { Counter, Histogram } from 'prom-client';
+import { register } from './registry.js';
+/**
+ * Qdrant Vector Database Metrics
+ *
+ * Tracks Qdrant operations, connection status, and performance.
+ */
+export const qdrantOperations = new Counter({
+    name: 'kairos_qdrant_operations_total',
+    help: 'Total number of Qdrant operations',
+    labelNames: ['operation', 'status', 'tenant_id'],
+    registers: [register]
+});
+export const qdrantOperationDuration = new Histogram({
+    name: 'kairos_qdrant_operation_duration_seconds',
+    help: 'Qdrant operation duration in seconds',
+    labelNames: ['operation', 'tenant_id'],
+    buckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],
+    registers: [register]
+});
+export const qdrantQueryDuration = new Histogram({
+    name: 'kairos_qdrant_query_duration_seconds',
+    help: 'Qdrant query execution duration in seconds',
+    labelNames: ['tenant_id'],
+    buckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5],
+    registers: [register]
+});
+export const qdrantUpsertDuration = new Histogram({
+    name: 'kairos_qdrant_upsert_duration_seconds',
+    help: 'Qdrant upsert operation duration in seconds',
+    labelNames: ['tenant_id'],
+    buckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5],
+    registers: [register]
+});
+//# sourceMappingURL=qdrant-metrics.js.map

package/dist/services/metrics/qdrant-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-metrics.js","sourceRoot":"","sources":["../../../src/services/metrics/qdrant-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;;GAIG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC;IAC1C,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,mCAAmC;IACzC,UAAU,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC;IAChD,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,SAAS,CAAC;IACnD,IAAI,EAAE,0CAA0C;IAChD,IAAI,EAAE,sCAAsC;IAC5C,UAAU,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IACzE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,SAAS,CAAC;IAC/C,IAAI,EAAE,sCAAsC;IAC5C,IAAI,EAAE,4CAA4C;IAClD,UAAU,EAAE,CAAC,WAAW,CAAC;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACrE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,SAAS,CAAC;IAChD,IAAI,EAAE,uCAAuC;IAC7C,IAAI,EAAE,6CAA6C;IACnD,UAAU,EAAE,CAAC,WAAW,CAAC;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACrE,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC"}

package/dist/services/metrics/registry.d.ts

@@ -0,0 +1,9 @@
+import { Registry } from 'prom-client';
+/**
+ * Prometheus metrics registry for KAIROS.
+ *
+ * All metrics are registered here and exposed via /metrics endpoint.
+ * Default labels are automatically applied to all metrics.
+ */
+export declare const register: Registry<"text/plain; version=0.0.4; charset=utf-8">;
+//# sourceMappingURL=registry.d.ts.map

package/dist/services/metrics/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/services/metrics/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,sDAAiB,CAAC"}

package/dist/services/metrics/registry.js

@@ -0,0 +1,19 @@
+import { Registry } from 'prom-client';
+import { getBuildVersion } from '../../utils/build-version.js';
+import os from 'os';
+/**
+ * Prometheus metrics registry for KAIROS.
+ *
+ * All metrics are registered here and exposed via /metrics endpoint.
+ * Default labels are automatically applied to all metrics.
+ */
+export const register = new Registry();
+// Set mandatory default labels on all metrics
+register.setDefaultLabels({
+    service: 'kairos',
+    kairos_version: getBuildVersion(),
+    instance: process.env['INSTANCE_ID'] || os.hostname() || 'unknown'
+});
+// Note: tenant_id is NOT a default label - it must be set per-metric
+// based on request context to ensure proper tenant isolation
+//# sourceMappingURL=registry.js.map

package/dist/services/metrics/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/services/metrics/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;AAEvC,8CAA8C;AAC9C,QAAQ,CAAC,gBAAgB,CAAC;IACxB,OAAO,EAAE,QAAQ;IACjB,cAAc,EAAE,eAAe,EAAE;IACjC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI,SAAS;CACnE,CAAC,CAAC;AAEH,qEAAqE;AACrE,6DAA6D"}

package/dist/services/metrics/system-metrics.d.ts

@@ -0,0 +1,10 @@
+import { Gauge } from 'prom-client';
+/**
+ * System Metrics
+ *
+ * Tracks application uptime, memory usage, and CPU usage.
+ */
+export declare const systemUptime: Gauge<string>;
+export declare const systemMemoryUsage: Gauge<"type">;
+export declare const systemProcessStartTime: Gauge<string>;
+//# sourceMappingURL=system-metrics.d.ts.map

package/dist/services/metrics/system-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-metrics.d.ts","sourceRoot":"","sources":["../../../src/services/metrics/system-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC;;;;GAIG;AAEH,eAAO,MAAM,YAAY,eAIvB,CAAC;AAEH,eAAO,MAAM,iBAAiB,eAK5B,CAAC;AAEH,eAAO,MAAM,sBAAsB,eAIjC,CAAC"}

package/dist/services/metrics/system-metrics.js

@@ -0,0 +1,35 @@
+import { Gauge } from 'prom-client';
+import { register } from './registry.js';
+/**
+ * System Metrics
+ *
+ * Tracks application uptime, memory usage, and CPU usage.
+ */
+export const systemUptime = new Gauge({
+    name: 'kairos_system_uptime_seconds',
+    help: 'Application uptime in seconds',
+    registers: [register]
+});
+export const systemMemoryUsage = new Gauge({
+    name: 'kairos_system_memory_usage_bytes',
+    help: 'System memory usage in bytes',
+    labelNames: ['type'],
+    registers: [register]
+});
+export const systemProcessStartTime = new Gauge({
+    name: 'kairos_system_process_start_time_seconds',
+    help: 'Process start timestamp (Unix epoch)',
+    registers: [register]
+});
+// Initialize system metrics
+const processStartTime = Date.now() / 1000;
+systemProcessStartTime.set(processStartTime);
+// Update uptime periodically
+setInterval(() => {
+    systemUptime.set(process.uptime());
+    const memUsage = process.memoryUsage();
+    systemMemoryUsage.set({ type: 'rss' }, memUsage.rss);
+    systemMemoryUsage.set({ type: 'heapTotal' }, memUsage.heapTotal);
+    systemMemoryUsage.set({ type: 'heapUsed' }, memUsage.heapUsed);
+}, 5000); // Update every 5 seconds
+//# sourceMappingURL=system-metrics.js.map

package/dist/services/metrics/system-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-metrics.js","sourceRoot":"","sources":["../../../src/services/metrics/system-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC;IACpC,IAAI,EAAE,8BAA8B;IACpC,IAAI,EAAE,+BAA+B;IACrC,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,KAAK,CAAC;IACzC,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,8BAA8B;IACpC,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,KAAK,CAAC;IAC9C,IAAI,EAAE,0CAA0C;IAChD,IAAI,EAAE,sCAAsC;IAC5C,SAAS,EAAE,CAAC,QAAQ,CAAC;CACtB,CAAC,CAAC;AAEH,4BAA4B;AAC5B,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3C,sBAAsB,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAE7C,6BAA6B;AAC7B,WAAW,CAAC,GAAG,EAAE;IACf,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEnC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACvC,iBAAiB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrD,iBAAiB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjE,iBAAiB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,yBAAyB"}

package/dist/services/oidc-state-store.d.ts

@@ -0,0 +1,29 @@
+/**
+ * OIDC login-transaction state store (PKCE code_verifier + state token).
+ *
+ * All state flows through the shared keyValueStore (Redis when configured,
+ * in-memory MemoryStore otherwise). There is a single backend-selection
+ * decision in key-value-store-factory.ts driven by `isRedisConfigured`;
+ * this module never checks REDIS_URL or deployment topology independently.
+ *
+ * Keys are global (no space namespace) because login has no space context.
+ */
+/** Shape stored per OIDC login transaction. */
+export interface OidcStateEntry {
+    codeVerifier: string;
+    createdAt: number;
+}
+export interface OidcStateStore {
+    /** Persist PKCE state for a new login transaction. */
+    set(state: string, entry: OidcStateEntry): Promise<void>;
+    /**
+     * Atomically consume (read-then-delete) a state entry.
+     * Returns the entry on first call, undefined on subsequent calls or after TTL.
+     */
+    consume(state: string): Promise<OidcStateEntry | undefined>;
+    /** Backend label for startup logging. */
+    readonly backend: 'redis' | 'memory';
+}
+/** Singleton OIDC state store. Backend is determined by isRedisConfigured in config. */
+export declare const oidcStateStore: OidcStateStore;
+//# sourceMappingURL=oidc-state-store.d.ts.map

package/dist/services/oidc-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oidc-state-store.d.ts","sourceRoot":"","sources":["../../src/services/oidc-state-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC5D,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;CACtC;AA8BD,wFAAwF;AACxF,eAAO,MAAM,cAAc,EAAE,cAA6C,CAAC"}

package/dist/services/oidc-state-store.js

@@ -0,0 +1,42 @@
+/**
+ * OIDC login-transaction state store (PKCE code_verifier + state token).
+ *
+ * All state flows through the shared keyValueStore (Redis when configured,
+ * in-memory MemoryStore otherwise). There is a single backend-selection
+ * decision in key-value-store-factory.ts driven by `isRedisConfigured`;
+ * this module never checks REDIS_URL or deployment topology independently.
+ *
+ * Keys are global (no space namespace) because login has no space context.
+ */
+import { isRedisConfigured, OIDC_STATE_KEY_PREFIX } from '../config.js';
+import { keyValueStore } from './key-value-store-factory.js';
+import { logger } from '../utils/structured-logger.js';
+/** TTL for OIDC state entries (10 minutes), in seconds for Redis SETEX. */
+const STATE_TTL_SECONDS = 600;
+/** Storage key for a given state token. */
+function stateKey(state) {
+    return `${OIDC_STATE_KEY_PREFIX}${state}`;
+}
+// ---------------------------------------------------------------------------
+// Unified implementation — delegates to keyValueStore (Redis or MemoryStore)
+// ---------------------------------------------------------------------------
+class KeyValueOidcStateStore {
+    backend = isRedisConfigured ? 'redis' : 'memory';
+    async set(state, entry) {
+        await keyValueStore.setJson(stateKey(state), entry, STATE_TTL_SECONDS);
+    }
+    async consume(state) {
+        // Atomic GETDEL via keyValueStore: no race window.
+        const entry = await keyValueStore.getdelJson(stateKey(state));
+        return entry ?? undefined;
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton
+// ---------------------------------------------------------------------------
+logger.info(isRedisConfigured
+    ? '[oidc-state] Using shared key-value store for OIDC state (Redis configured)'
+    : '[oidc-state] Using in-memory key-value store for OIDC state (Redis not configured)');
+/** Singleton OIDC state store. Backend is determined by isRedisConfigured in config. */
+export const oidcStateStore = new KeyValueOidcStateStore();
+//# sourceMappingURL=oidc-state-store.js.map

package/dist/services/oidc-state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oidc-state-store.js","sourceRoot":"","sources":["../../src/services/oidc-state-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD,2EAA2E;AAC3E,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAQ9B,2CAA2C;AAC3C,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,GAAG,qBAAqB,GAAG,KAAK,EAAE,CAAC;AAC5C,CAAC;AAkBD,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAE9E,MAAM,sBAAsB;IACjB,OAAO,GAAuB,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE9E,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,KAAqB;QAC5C,MAAM,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa;QACzB,mDAAmD;QACnD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,UAAU,CAAiB,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9E,OAAO,KAAK,IAAI,SAAS,CAAC;IAC5B,CAAC;CACF;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,IAAI,CACT,iBAAiB;IACf,CAAC,CAAC,6EAA6E;IAC/E,CAAC,CAAC,oFAAoF,CACzF,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAmB,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/services/proof-of-work-store.d.ts

@@ -0,0 +1,66 @@
+export type ProofOfWorkStatus = 'success' | 'failed';
+export type ProofOfWorkType = 'shell' | 'mcp' | 'user_input' | 'comment';
+export interface ProofOfWorkResultRecord {
+    result_id: string;
+    type?: ProofOfWorkType;
+    status: ProofOfWorkStatus;
+    executed_at: string;
+    exit_code?: number;
+    duration_seconds?: number;
+    stdout?: string;
+    stderr?: string;
+    shell?: {
+        exit_code: number;
+        stdout?: string;
+        stderr?: string;
+        duration_seconds?: number;
+    };
+    mcp?: {
+        tool_name: string;
+        arguments?: any;
+        result: any;
+        success: boolean;
+    };
+    user_input?: {
+        confirmation: string;
+        timestamp?: string;
+    };
+    comment?: {
+        text: string;
+    };
+}
+/** Max retries before escalating to must_obey: false. */
+export declare const MAX_RETRIES = 3;
+export declare class ProofOfWorkStore {
+    private readonly prefix;
+    private readonly noncePrefix;
+    private readonly hashPrefix;
+    private readonly retryPrefix;
+    private buildKey;
+    private nonceKey;
+    private hashKey;
+    saveResult(memoryUuid: string, record: ProofOfWorkResultRecord): Promise<void>;
+    getResult(memoryUuid: string): Promise<ProofOfWorkResultRecord | null>;
+    setNonce(memoryUuid: string, nonce: string): Promise<void>;
+    getNonce(memoryUuid: string): Promise<string | null>;
+    setProofHash(memoryUuid: string, hash: string): Promise<void>;
+    getProofHash(memoryUuid: string): Promise<string | null>;
+    private retryKey;
+    /**
+     * Increment retry count for this challenge instance.
+     * @param identifier - Step's current nonce when available, otherwise step uuid.
+     */
+    incrementRetry(identifier: string): Promise<number>;
+    /**
+     * Get retry count for this challenge instance.
+     * @param identifier - Step's current nonce when available, otherwise step uuid.
+     */
+    getRetryCount(identifier: string): Promise<number>;
+    /**
+     * Reset retry count for this challenge instance.
+     * @param identifier - Step's current nonce when available, otherwise step uuid.
+     */
+    resetRetry(identifier: string): Promise<void>;
+}
+export declare const proofOfWorkStore: ProofOfWorkStore;
+//# sourceMappingURL=proof-of-work-store.d.ts.map

package/dist/services/proof-of-work-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-of-work-store.d.ts","sourceRoot":"","sources":["../../src/services/proof-of-work-store.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,KAAK,GAAG,YAAY,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,GAAG,CAAC;QAChB,MAAM,EAAE,GAAG,CAAC;QACZ,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAQD,yDAAyD;AACzD,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAE5C,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAIT,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9E,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAUtE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUpD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7D,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAU9D,OAAO,CAAC,QAAQ;IAIhB;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYzD;;;OAGG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWxD;;;OAGG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQpD;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}