@miller-tech/uap 1.5.5 → 1.5.7

package/dist/types/coordination.d.ts

@@ -115,23 +115,23 @@ export declare const AgentRegistryEntrySchema: z.ZodObject<{
     lastHeartbeat: z.ZodString;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    status: "active" | "idle" | "completed" | "failed";
     name: string;
     id: string;
+    status: "failed" | "active" | "idle" | "completed";
     sessionId: string;
     startedAt: string;
     lastHeartbeat: string;
-    capabilities?: string[] | undefined;
     currentTask?: string | undefined;
+    capabilities?: string[] | undefined;
 }, {
-    status: "active" | "idle" | "completed" | "failed";
     name: string;
     id: string;
+    status: "failed" | "active" | "idle" | "completed";
     sessionId: string;
     startedAt: string;
     lastHeartbeat: string;
-    capabilities?: string[] | undefined;
     currentTask?: string | undefined;
+    capabilities?: string[] | undefined;
 }>;
 export declare const MessagePayloadSchema: z.ZodObject<{
     action: z.ZodString;
@@ -139,12 +139,12 @@ export declare const MessagePayloadSchema: z.ZodObject<{
     data: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
     action: string;
-    resource?: string | undefined;
     data?: unknown;
+    resource?: string | undefined;
 }, {
     action: string;
-    resource?: string | undefined;
     data?: unknown;
+    resource?: string | undefined;
 }>;
 export declare const AgentMessageSchema: z.ZodObject<{
     id: z.ZodNumber;
@@ -158,42 +158,42 @@ export declare const AgentMessageSchema: z.ZodObject<{
         data: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         action: string;
-        resource?: string | undefined;
         data?: unknown;
+        resource?: string | undefined;
     }, {
         action: string;
-        resource?: string | undefined;
         data?: unknown;
+        resource?: string | undefined;
     }>;
     priority: z.ZodDefault<z.ZodNumber>;
     createdAt: z.ZodString;
     readAt: z.ZodOptional<z.ZodString>;
     expiresAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "request" | "response" | "notification" | "claim" | "release";
     id: number;
+    type: "release" | "claim" | "notification" | "request" | "response";
+    createdAt: string;
     priority: number;
-    channel: "deploy" | "review" | "broadcast" | "direct" | "coordination";
+    channel: "deploy" | "coordination" | "broadcast" | "review" | "direct";
     payload: {
         action: string;
-        resource?: string | undefined;
         data?: unknown;
+        resource?: string | undefined;
     };
-    createdAt: string;
     fromAgent?: string | undefined;
     toAgent?: string | undefined;
     readAt?: string | undefined;
     expiresAt?: string | undefined;
 }, {
-    type: "request" | "response" | "notification" | "claim" | "release";
     id: number;
-    channel: "deploy" | "review" | "broadcast" | "direct" | "coordination";
+    type: "release" | "claim" | "notification" | "request" | "response";
+    createdAt: string;
+    channel: "deploy" | "coordination" | "broadcast" | "review" | "direct";
     payload: {
         action: string;
-        resource?: string | undefined;
         data?: unknown;
+        resource?: string | undefined;
     };
-    createdAt: string;
     priority?: number | undefined;
     fromAgent?: string | undefined;
     toAgent?: string | undefined;
@@ -213,28 +213,28 @@ export declare const DeployActionSchema: z.ZodObject<{
     priority: z.ZodDefault<z.ZodNumber>;
     dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    status: "completed" | "failed" | "pending" | "batched" | "executing";
     id: number;
+    status: "failed" | "completed" | "pending" | "batched" | "executing";
     priority: number;
     agentId: string;
-    actionType: "push" | "commit" | "merge" | "workflow" | "deploy";
+    actionType: "deploy" | "push" | "commit" | "merge" | "workflow";
     target: string;
     queuedAt: string;
     payload?: Record<any, any> | undefined;
+    dependencies?: string[] | undefined;
     batchId?: string | undefined;
     executeAfter?: string | undefined;
-    dependencies?: string[] | undefined;
 }, {
-    status: "completed" | "failed" | "pending" | "batched" | "executing";
     id: number;
+    status: "failed" | "completed" | "pending" | "batched" | "executing";
     agentId: string;
-    actionType: "push" | "commit" | "merge" | "workflow" | "deploy";
+    actionType: "deploy" | "push" | "commit" | "merge" | "workflow";
     target: string;
     queuedAt: string;
     priority?: number | undefined;
     payload?: Record<any, any> | undefined;
+    dependencies?: string[] | undefined;
     batchId?: string | undefined;
     executeAfter?: string | undefined;
-    dependencies?: string[] | undefined;
 }>;
 //# sourceMappingURL=coordination.d.ts.map

package/dist/uap-droids-strict.d.ts

@@ -29,12 +29,12 @@ export declare const DROID_SCHEMA: z.ZodObject<{
 }, {
     name: string;
     description: string;
-    model?: "inherit" | "dedicated" | undefined;
     coordination?: {
         channels?: string[] | undefined;
         claims?: ("exclusive" | "shared")[] | undefined;
         batches_deploy?: boolean | undefined;
     } | undefined;
+    model?: "inherit" | "dedicated" | undefined;
 }>;
 interface DroidMeta {
     name: string;

package/dist/utils/adaptive-cache.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Adaptive cache with usage-based TTL and priority eviction
+ */
+export interface CacheEntry<V> {
+    value: V;
+    lastAccessed: Date;
+    lastModified: Date;
+    usageCount: number;
+    priority: number;
+}
+export interface AdaptiveCacheOptions {
+    maxEntries: number;
+    defaultTTL?: number;
+    hotThreshold?: number;
+    coldEvictionRatio?: number;
+}
+export declare class AdaptiveCache<K, V> {
+    private cache;
+    private options;
+    private evictionInterval;
+    constructor(options: AdaptiveCacheOptions);
+    /**
+     * Get value from cache with adaptive TTL
+     */
+    get(key: K): V | null;
+    /**
+     * Set value in cache
+     */
+    set(key: K, value: V, priority?: number): void;
+    /**
+     * Delete value from cache
+     */
+    delete(key: K): boolean;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+    /**
+     * Calculate adaptive TTL based on usage patterns
+     */
+    private getAdaptiveTTL;
+    /**
+     * Evict entries based on priority and access patterns
+     */
+    private evict;
+    /**
+     * Start periodic eviction
+     */
+    private startEviction;
+    /**
+     * Stop eviction interval
+     */
+    stop(): void;
+}
+/**
+ * Create a cache instance with common defaults for pattern matching
+ */
+export declare function createPatternCache(maxEntries?: number): AdaptiveCache<string, any>;
+/**
+ * Create a cache instance for short-term query results
+ */
+export declare function createQueryCache(maxEntries?: number): AdaptiveCache<string, any>;
+//# sourceMappingURL=adaptive-cache.d.ts.map

package/dist/utils/adaptive-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-cache.d.ts","sourceRoot":"","sources":["../../src/utils/adaptive-cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,YAAY,EAAE,IAAI,CAAC;IACnB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,aAAa,CAAC,CAAC,EAAE,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,gBAAgB,CAA+B;gBAE3C,OAAO,EAAE,oBAAoB;IAmBzC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI;IAoBrB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,GAAE,MAAU,GAAG,IAAI;IAejD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,KAAK;IAgCb;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,IAAI,IAAI,IAAI;CAMb;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,GAAE,MAAY,GAAG,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAOvF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,MAAW,GAAG,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAOpF"}

package/dist/utils/adaptive-cache.js

@@ -0,0 +1,149 @@
+export class AdaptiveCache {
+    cache;
+    options;
+    evictionInterval = null;
+    constructor(options) {
+        const { maxEntries, defaultTTL = 300000, // 5 minutes
+        hotThreshold = 10, coldEvictionRatio = 0.5, } = options;
+        this.options = {
+            maxEntries,
+            defaultTTL,
+            hotThreshold,
+            coldEvictionRatio,
+        };
+        this.cache = new Map();
+        this.startEviction();
+    }
+    /**
+     * Get value from cache with adaptive TTL
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        // Check if expired
+        const age = Date.now() - entry.lastModified.getTime();
+        const ttl = this.getAdaptiveTTL(entry);
+        if (age > ttl) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Update access metadata
+        entry.lastAccessed = new Date();
+        entry.usageCount++;
+        return entry.value;
+    }
+    /**
+     * Set value in cache
+     */
+    set(key, value, priority = 1) {
+        // Evict if at capacity
+        if (this.cache.size >= this.options.maxEntries) {
+            this.evict();
+        }
+        this.cache.set(key, {
+            value,
+            lastAccessed: new Date(),
+            lastModified: new Date(),
+            usageCount: 0,
+            priority,
+        });
+    }
+    /**
+     * Delete value from cache
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache size
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Calculate adaptive TTL based on usage patterns
+     */
+    getAdaptiveTTL(entry) {
+        if (entry.usageCount >= this.options.hotThreshold) {
+            return this.options.defaultTTL * 12; // 1 hour for hot entries
+        }
+        if (entry.usageCount >= this.options.hotThreshold / 2) {
+            return this.options.defaultTTL * 3; // 15 minutes for warm entries
+        }
+        return this.options.defaultTTL; // 5 minutes default
+    }
+    /**
+     * Evict entries based on priority and access patterns
+     */
+    evict() {
+        const entries = [...this.cache.entries()];
+        if (entries.length === 0)
+            return;
+        // Separate hot vs cold entries
+        const coldEntries = entries.filter(([_, entry]) => entry.usageCount < this.options.hotThreshold / 2);
+        // hotEntries unused - kept for future expansion
+        // Evict cold first
+        if (coldEntries.length > Math.floor(this.options.maxEntries * this.options.coldEvictionRatio)) {
+            // Sort by last access time
+            coldEntries.sort((a, b) => a[1].lastAccessed.getTime() - b[1].lastAccessed.getTime());
+            const toRemove = Math.floor(coldEntries.length / 2);
+            for (let i = 0; i < toRemove; i++) {
+                this.cache.delete(coldEntries[i][0]);
+            }
+            return;
+        }
+        // If not enough cold entries, evict LRU from all
+        entries.sort((a, b) => a[1].lastAccessed.getTime() - b[1].lastAccessed.getTime());
+        const toRemove = Math.ceil(entries.length * 0.3);
+        for (let i = 0; i < toRemove; i++) {
+            this.cache.delete(entries[i][0]);
+        }
+    }
+    /**
+     * Start periodic eviction
+     */
+    startEviction() {
+        this.evictionInterval = setInterval(() => {
+            this.evict();
+        }, 60000); // Run every minute
+    }
+    /**
+     * Stop eviction interval
+     */
+    stop() {
+        if (this.evictionInterval) {
+            clearInterval(this.evictionInterval);
+            this.evictionInterval = null;
+        }
+    }
+}
+/**
+ * Create a cache instance with common defaults for pattern matching
+ */
+export function createPatternCache(maxEntries = 100) {
+    return new AdaptiveCache({
+        maxEntries,
+        defaultTTL: 300000, // 5 minutes
+        hotThreshold: 10,
+        coldEvictionRatio: 0.5,
+    });
+}
+/**
+ * Create a cache instance for short-term query results
+ */
+export function createQueryCache(maxEntries = 50) {
+    return new AdaptiveCache({
+        maxEntries,
+        defaultTTL: 60000, // 1 minute
+        hotThreshold: 5,
+        coldEvictionRatio: 0.7,
+    });
+}
+//# sourceMappingURL=adaptive-cache.js.map

package/dist/utils/adaptive-cache.js.map

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

package/dist/utils/performance-monitor.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Performance monitoring utilities for measuring and analyzing operation metrics
+ */
+export interface PerformanceMetrics {
+    avg: number;
+    p50: number;
+    p95: number;
+    p99: number;
+    min: number;
+    max: number;
+    count: number;
+}
+/**
+ * Monitor performance of operations with percentile tracking
+ */
+export declare class PerformanceMonitor {
+    private metrics;
+    private readonly maxSamples;
+    constructor(options?: {
+        maxSamples?: number;
+    });
+    /**
+     * Measure and record duration of an async operation
+     */
+    measure<T>(name: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Record a metric directly
+     */
+    record(metric: string, duration: number): void;
+    /**
+     * Get statistics for a metric
+     */
+    getStats(metric: string): PerformanceMetrics | null;
+    /**
+     * Get all metric names
+     */
+    getMetrics(): string[];
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+    /**
+     * Export metrics as JSON
+     */
+    exportMetrics(): Record<string, PerformanceMetrics>;
+}
+export declare function getPerformanceMonitor(): PerformanceMonitor;
+/**
+ * Helper to wrap any function with performance monitoring
+ */
+export declare function monitorFunction<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, name?: string): T;
+//# sourceMappingURL=performance-monitor.d.ts.map

package/dist/utils/performance-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-monitor.d.ts","sourceRoot":"","sources":["../../src/utils/performance-monitor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAI7C;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAUhE;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAa9C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAkBnD;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;CAYpD;AAOD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAChF,EAAE,EAAE,CAAC,EACL,IAAI,CAAC,EAAE,MAAM,GACZ,CAAC,CAOH"}

package/dist/utils/performance-monitor.js

@@ -0,0 +1,103 @@
+/**
+ * Performance monitoring utilities for measuring and analyzing operation metrics
+ */
+/**
+ * Monitor performance of operations with percentile tracking
+ */
+export class PerformanceMonitor {
+    metrics = new Map();
+    maxSamples;
+    constructor(options) {
+        this.maxSamples = options?.maxSamples ?? 1000;
+    }
+    /**
+     * Measure and record duration of an async operation
+     */
+    async measure(name, fn) {
+        const start = performance.now();
+        try {
+            return await fn();
+        }
+        finally {
+            const duration = performance.now() - start;
+            this.record(name, duration);
+        }
+    }
+    /**
+     * Record a metric directly
+     */
+    record(metric, duration) {
+        const entries = this.metrics.get(metric) || [];
+        entries.push(duration);
+        // Keep last N samples
+        if (entries.length > this.maxSamples) {
+            entries.shift();
+        }
+        this.metrics.set(metric, entries);
+    }
+    /**
+     * Get statistics for a metric
+     */
+    getStats(metric) {
+        const entries = this.metrics.get(metric);
+        if (!entries || entries.length === 0)
+            return null;
+        const sorted = [...entries].sort((a, b) => a - b);
+        const count = sorted.length;
+        return {
+            avg: sorted.reduce((a, b) => a + b, 0) / count,
+            p50: sorted[Math.floor(count * 0.5)] ?? 0,
+            p95: sorted[Math.floor(count * 0.95)] ?? 0,
+            p99: sorted[Math.floor(count * 0.99)] ?? 0,
+            min: sorted[0] ?? 0,
+            max: sorted[count - 1] ?? 0,
+            count,
+        };
+    }
+    /**
+     * Get all metric names
+     */
+    getMetrics() {
+        return [...this.metrics.keys()];
+    }
+    /**
+     * Clear all metrics
+     */
+    clear() {
+        this.metrics.clear();
+    }
+    /**
+     * Export metrics as JSON
+     */
+    exportMetrics() {
+        const result = {};
+        for (const metric of this.metrics.keys()) {
+            const stats = this.getStats(metric);
+            if (stats) {
+                result[metric] = stats;
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Global performance monitor instance
+ */
+let globalMonitor = null;
+export function getPerformanceMonitor() {
+    if (!globalMonitor) {
+        globalMonitor = new PerformanceMonitor();
+    }
+    return globalMonitor;
+}
+/**
+ * Helper to wrap any function with performance monitoring
+ */
+export function monitorFunction(fn, name) {
+    const monitor = getPerformanceMonitor();
+    const metricName = (name ?? fn.name) || 'anonymous';
+    return (async (...args) => {
+        return monitor.measure(metricName, async () => await fn(...args));
+    });
+}
+//# sourceMappingURL=performance-monitor.js.map

package/dist/utils/performance-monitor.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miller-tech/uap",
-  "version": "1.5.5",
+  "version": "1.5.7",
   "description": "Autonomous AI agent memory system with CLAUDE.md protocol enforcement",
   "type": "module",
   "main": "dist/index.js",