reflectt-node 0.1.20 → 0.1.22

package/dist/stall-detector.d.ts

@@ -0,0 +1,109 @@
+/**
+ * StallDetector — event-driven stall detection
+ *
+ * Detects when users go inactive during key lifecycle moments:
+ * - New user stall: 4 min inactivity post-first-action
+ * - In-session stall: 6 min inactivity post-agent-response
+ * - Setup stall: 5 min onboarding inactivity
+ *
+ * Emits stall events that the InterventionTemplateEngine can consume.
+ */
+export type StallType = 'new_user_stall' | 'in_session_stall' | 'setup_stall' | 'task_stalled' | 'review_pending' | 'handoff_waiting' | 'approval_pending';
+export type SessionPhase = 'new_user' | 'in_session' | 'setup';
+export interface StallContext {
+    userId: string;
+    sessionId: string;
+    lastAction?: string;
+    lastAgent?: string;
+    lastActionAt?: number;
+}
+export interface StallEvent {
+    stallId: string;
+    userId: string;
+    sessionId: string;
+    stallType: StallType;
+    context: StallContext;
+    timestamp: number;
+    thresholdMinutes: number;
+    inactivityMinutes: number;
+}
+export interface StallThresholds {
+    newUserStallMinutes: number;
+    inSessionStallMinutes: number;
+    setupStallMinutes: number;
+}
+export interface StallDetectorConfig {
+    thresholds: StallThresholds;
+    enabled: boolean;
+}
+export declare const DEFAULT_THRESHOLDS: StallThresholds;
+export declare const DEFAULT_CONFIG: StallDetectorConfig;
+type StallEventHandler = (event: StallEvent) => void;
+export declare function onStallEvent(handler: StallEventHandler): () => void;
+/**
+ * Emit a workflow stall event (task_stalled, review_pending, etc.)
+ * Call this from task lifecycle events — no session tracking needed.
+ */
+export declare function emitWorkflowStall(userId: string, stallType: 'task_stalled' | 'review_pending' | 'handoff_waiting' | 'approval_pending', context?: {
+    lastAction?: string;
+    lastAgent?: string;
+    lastActionAt?: number;
+}): void;
+interface UserSessionState {
+    userId: string;
+    sessionId: string;
+    phase: SessionPhase;
+    lastActionAt: number;
+    lastAgentResponseAt?: number;
+    firstActionAt?: number;
+    stallFired: Set<string>;
+    context?: StallContext;
+}
+/**
+ * Record a user action (message sent, button clicked, etc.)
+ */
+export declare function recordUserAction(userId: string, sessionId: string, action: string, timestamp?: number): void;
+/**
+ * Record an agent response
+ */
+export declare function recordAgentResponse(userId: string, sessionId: string, agentName: string, timestamp?: number): void;
+/**
+ * Check all sessions for stalls and emit events
+ */
+export declare function checkForStalls(config?: StallDetectorConfig, now?: number): StallEvent[];
+/**
+ * Transition a session's phase
+ */
+export declare function transitionSessionPhase(userId: string, sessionId: string, newPhase: SessionPhase): void;
+/**
+ * Clear a session (user completed the flow)
+ */
+export declare function clearSession(userId: string, sessionId: string): void;
+/**
+ * Get current state for a session
+ */
+export declare function getSessionState(userId: string, sessionId: string): UserSessionState | undefined;
+/**
+ * Get all active sessions
+ */
+export declare function getActiveSessions(): UserSessionState[];
+/**
+ * Cleanup old sessions (call periodically)
+ */
+export declare function cleanupStaleSessions(maxAgeMs?: number): number;
+export declare function _resetStallDetectorState(): void;
+export declare class StallDetector {
+    private config;
+    constructor(config?: Partial<StallDetectorConfig>);
+    getAllStates(): UserSessionState[];
+    getState(userId: string): UserSessionState | undefined;
+    recordActivity(userId: string, options?: {
+        phase?: SessionPhase;
+        sessionId?: string;
+    }): void;
+    recordAgentResponse(userId: string, agentId: string): void;
+    start(): void;
+}
+export declare function getStallDetector(): StallDetector;
+export {};
+//# sourceMappingURL=stall-detector.d.ts.map

package/dist/stall-detector.d.ts.map

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

package/dist/stall-detector.js

@@ -0,0 +1,279 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * StallDetector — event-driven stall detection
+ *
+ * Detects when users go inactive during key lifecycle moments:
+ * - New user stall: 4 min inactivity post-first-action
+ * - In-session stall: 6 min inactivity post-agent-response
+ * - Setup stall: 5 min onboarding inactivity
+ *
+ * Emits stall events that the InterventionTemplateEngine can consume.
+ */
+export const DEFAULT_THRESHOLDS = {
+    newUserStallMinutes: 4,
+    inSessionStallMinutes: 6,
+    setupStallMinutes: 5,
+};
+export const DEFAULT_CONFIG = {
+    thresholds: DEFAULT_THRESHOLDS,
+    enabled: false, // Defaults to false until validated
+};
+const stallHandlers = new Set();
+export function onStallEvent(handler) {
+    stallHandlers.add(handler);
+    return () => stallHandlers.delete(handler);
+}
+function emitStallEvent(event) {
+    for (const handler of stallHandlers) {
+        try {
+            handler(event);
+        }
+        catch (err) {
+            console.error('[StallDetector] Handler error:', err);
+        }
+    }
+}
+/**
+ * Emit a workflow stall event (task_stalled, review_pending, etc.)
+ * Call this from task lifecycle events — no session tracking needed.
+ */
+export function emitWorkflowStall(userId, stallType, context = {}) {
+    const event = {
+        stallId: `workflow-${userId}-${stallType}-${Date.now()}`,
+        userId,
+        sessionId: `workflow:${stallType}`,
+        stallType,
+        context: { userId, sessionId: `workflow:${stallType}`, ...context },
+        timestamp: Date.now(),
+        thresholdMinutes: 5, // default, overridden by caller
+        inactivityMinutes: 0,
+    };
+    emitStallEvent(event);
+}
+const sessionStates = new Map(); // Key: `${userId}:${sessionId}`
+// Track last check time to avoid duplicate stalls
+const lastCheckTimes = new Map();
+/**
+ * Record a user action (message sent, button clicked, etc.)
+ */
+export function recordUserAction(userId, sessionId, action, timestamp = Date.now()) {
+    const key = `${userId}:${sessionId}`;
+    let state = sessionStates.get(key);
+    if (!state) {
+        state = {
+            userId,
+            sessionId,
+            phase: 'new_user',
+            lastActionAt: timestamp,
+            stallFired: new Set(),
+        };
+        sessionStates.set(key, state);
+    }
+    state.lastActionAt = timestamp;
+    if (!state.firstActionAt) {
+        state.firstActionAt = timestamp;
+    }
+}
+/**
+ * Record an agent response
+ */
+export function recordAgentResponse(userId, sessionId, agentName, timestamp = Date.now()) {
+    const key = `${userId}:${sessionId}`;
+    let state = sessionStates.get(key);
+    if (!state) {
+        // Agent responded but we have no user state - create it
+        state = {
+            userId,
+            sessionId,
+            phase: 'setup',
+            lastActionAt: timestamp,
+            stallFired: new Set(),
+        };
+        sessionStates.set(key, state);
+    }
+    state.lastAgentResponseAt = timestamp;
+}
+/**
+ * Check all sessions for stalls and emit events
+ */
+export function checkForStalls(config = DEFAULT_CONFIG, now = Date.now()) {
+    if (!config.enabled)
+        return [];
+    // now injected for testability (defaults to Date.now())
+    const emitted = [];
+    for (const [key, state] of sessionStates) {
+        // Skip if stall already fired for this session
+        if (state.stallFired.size > 0)
+            continue;
+        // Skip if checked recently (within 30 seconds)
+        const lastCheck = lastCheckTimes.get(key) ?? 0;
+        if (now - lastCheck < 30_000)
+            continue;
+        lastCheckTimes.set(key, now);
+        let thresholdMinutes;
+        let stallType;
+        let inactivityMs;
+        if (state.phase === 'new_user') {
+            thresholdMinutes = config.thresholds.newUserStallMinutes;
+            stallType = 'new_user_stall';
+            inactivityMs = state.lastAgentResponseAt
+                ? now - state.lastAgentResponseAt
+                : now - state.lastActionAt;
+        }
+        else if (state.phase === 'in_session') {
+            thresholdMinutes = config.thresholds.inSessionStallMinutes;
+            stallType = 'in_session_stall';
+            inactivityMs = state.lastAgentResponseAt
+                ? now - state.lastAgentResponseAt
+                : now - state.lastActionAt;
+        }
+        else {
+            thresholdMinutes = config.thresholds.setupStallMinutes;
+            stallType = 'setup_stall';
+            inactivityMs = now - state.lastActionAt;
+        }
+        const thresholdMs = thresholdMinutes * 60_000;
+        if (inactivityMs >= thresholdMs) {
+            // Stall detected!
+            state.stallFired.add(stallType);
+            const event = {
+                stallId: `stall-${key}-${now}`,
+                userId: state.userId,
+                sessionId: state.sessionId,
+                stallType,
+                context: {
+                    userId: state.userId,
+                    sessionId: state.sessionId,
+                    lastAction: 'user_action',
+                    lastAgent: 'agent',
+                    lastActionAt: state.lastActionAt,
+                },
+                timestamp: now,
+                thresholdMinutes,
+                inactivityMinutes: Math.round(inactivityMs / 60_000),
+            };
+            emitStallEvent(event);
+            emitted.push(event);
+        }
+    }
+    return emitted;
+}
+/**
+ * Transition a session's phase
+ */
+export function transitionSessionPhase(userId, sessionId, newPhase) {
+    const key = `${userId}:${sessionId}`;
+    const state = sessionStates.get(key);
+    if (state) {
+        state.phase = newPhase;
+        // Reset stall fired when transitioning phases
+        state.stallFired.clear();
+    }
+}
+/**
+ * Clear a session (user completed the flow)
+ */
+export function clearSession(userId, sessionId) {
+    const key = `${userId}:${sessionId}`;
+    sessionStates.delete(key);
+    lastCheckTimes.delete(key);
+}
+/**
+ * Get current state for a session
+ */
+export function getSessionState(userId, sessionId) {
+    return sessionStates.get(`${userId}:${sessionId}`);
+}
+/**
+ * Get all active sessions
+ */
+export function getActiveSessions() {
+    return [...sessionStates.values()];
+}
+/**
+ * Cleanup old sessions (call periodically)
+ */
+export function cleanupStaleSessions(maxAgeMs = 30 * 60 * 1000) {
+    const now = Date.now();
+    let cleaned = 0;
+    for (const [key, state] of sessionStates) {
+        const lastActivity = state.lastAgentResponseAt ?? state.lastActionAt;
+        if (now - lastActivity > maxAgeMs) {
+            sessionStates.delete(key);
+            lastCheckTimes.delete(key);
+            cleaned++;
+        }
+    }
+    return cleaned;
+}
+// For testing: reset all state
+export function _resetStallDetectorState() {
+    sessionStates.clear();
+    lastCheckTimes.clear();
+}
+// ── StallDetector class (for test compatibility) ─────────────────────────────────
+let _stallDetectorInstance = null;
+export class StallDetector {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    getAllStates() {
+        return [...sessionStates.values()];
+    }
+    getState(userId) {
+        for (const state of sessionStates.values()) {
+            if (state.userId === userId)
+                return state;
+        }
+        return undefined;
+    }
+    recordActivity(userId, options) {
+        const now = Date.now();
+        let state = this.getState(userId);
+        const sessionId = options?.sessionId ?? `session-${userId}`;
+        const key = `${userId}:${sessionId}`;
+        if (!state) {
+            state = { userId, sessionId, phase: options?.phase ?? 'new_user', lastActionAt: now, stallFired: new Set() };
+            sessionStates.set(key, state);
+        }
+        else {
+            if (options?.phase)
+                state.phase = options.phase;
+            state.lastActionAt = now;
+        }
+    }
+    recordAgentResponse(userId, agentId) {
+        const now = Date.now();
+        for (const state of sessionStates.values()) {
+            if (state.userId === userId) {
+                state.lastAgentResponseAt = now;
+                break;
+            }
+        }
+    }
+    start() {
+        // Periodic stall check — run every 60s when enabled
+        if (this.config.enabled)
+            return; // already running
+        this.config.enabled = true;
+        setInterval(() => {
+            if (!this.config.enabled)
+                return;
+            try {
+                checkForStalls(this.config);
+            }
+            catch (err) {
+                console.error('[StallDetector] Check error:', err);
+            }
+        }, 60_000);
+    }
+}
+// Singleton accessor
+export function getStallDetector() {
+    if (!_stallDetectorInstance) {
+        _stallDetectorInstance = new StallDetector();
+    }
+    return _stallDetectorInstance;
+}
+//# sourceMappingURL=stall-detector.js.map

package/dist/stall-detector.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reflectt-node",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "Coordinate your AI agent team. Shared tasks, memory, reflections, and presence. Self-host for free.",
   "main": "dist/index.js",
   "type": "module",

package/public/docs.md

@@ -141,6 +141,9 @@ Remote hosts (multi-host installs) phone-home via a lightweight heartbeat so the
 | POST | `/health/mention-rescue/tick` | Trigger mention-rescue fallback |
 | POST | `/health/working-contract/tick` | Evaluate working-contract enforcement: auto-requeue stale doing tasks (90m warning → 15m grace → auto todo) and fire alerts. |
 | GET | `/health/working-contract/gate/:agent` | Dry-run claim gate check for an agent. Returns `{ allowed, reason }` — whether the agent can claim a new task given current WIP and contract status. |
+| GET | `/stall-detector` | Stall detection status: enabled flag and all tracked session states. Returns `{ enabled, states: [{ userId, phase, context, stallFired[] }] }`. |
+| POST | `/stall-detector/config` | Update stall detector config. Body: `{ enabled?: boolean, thresholds?: { newUserStallMinutes?, inSessionStallMinutes?, setupStallMinutes? } }`. Returns `{ success, config }`. |
+| POST | `/stall-detector/test` | Record test activity for a userId. Body: `{ userId }`. Returns `{ success, message }`. |
 
 ### Quick system-loop check
 
@@ -836,6 +839,7 @@ Autonomous work-continuity system. Monitors agent queue floors and auto-replenis
 | GET | `/canvas/history` | Recent render history (?slot=&limit=) |
 | GET | `/canvas/rejections` | Recent contract validation rejections |
 | GET | `/canvas/stream` | SSE stream of canvas render events |
+| GET | `/canvas/viewers` | Returns `{ viewers: number }` — count of open SSE connections to `/canvas/stream`. Used by reflectt-cloud /live page to show real-time viewer count. |
 | GET | `/execution-health` | Execution sweeper status: validating queue violations, SLA breaches, escalation tracking. |
 | POST | `/pr-event` | PR state webhook. Body: `{ taskId, prState: "merged"|"closed", prUrl? }`. Auto-updates task artifacts on merge, auto-blocks on close. |
 | GET | `/pr-automerge/status` | PR auto-merge attempt log: recent merge/close attempts with summary counts (attempted, success, failed, skipped, auto-close, close-gate-fail). |
@@ -1167,10 +1171,15 @@ Auth-gated endpoints for managing a reflectt-node instance remotely. Provide `RE
 | POST | `/canvas/takeover/release` | **Release takeover** — agent gives back the screen. Body: `{ agentId, transition?: 'fade'\|'slide'\|'instant' }`. Only the owning agent can release. Emits `canvas_takeover` with `action: 'release'`. |
 | GET | `/canvas/takeover` | **Takeover state** — returns current takeover status: `{ active, agentId?, id?, title?, startedAt?, expiresAt?, remainingMs? }`. |
 | GET | `/canvas/render/stream` | **Reality Mixer SSE stream** — subscribe to receive real-time medium commands from agents. New subscribers get last 20 commands for catch-up (event type `replay`). Live commands arrive as `data` events. Shape: `{ id, ts, agentId, cmd: { type, ...fields } }`. |
+| GET | `/canvas/capability` | **Get all agent capabilities** — returns registered capabilities for all agents. Returns `{ capabilities: AgentCapabilities[] }`. |
+| POST | `/canvas/capability` | **Register agent capabilities** — register or update capabilities. Body: `{ agentId, agentName?, capabilities: Capability[] }`. Broadcasts `capability_setup` SSE event to `/canvas/render/stream` subscribers. Returns `{ ok, agentId, count }`. |
+| GET | `/audio/:id` | **Serve cached TTS audio** — serves MP3 audio cached from Kokoro TTS. Audio cached for 30 minutes by SHA256(text + voice) key. Returns 404 if not found or expired. |
+| POST | `/canvas/speak` | **Generate TTS audio + emit voice_output SSE** — generates speech via Kokoro TTS (with ElevenLabs fallback), caches result, emits `voice_queued` immediately + `voice_output` with audio URL to all `/canvas/render/stream` subscribers. Body: `{ text, agentId, agentName? }`. Returns `{ ok, voiceId, estimatedMs }` immediately. `voice_output` SSE fires when audio is ready (~90s cold start). Voice map: link/safari→af_sarah, kai/kotlin/pixel/echo/harmony→af_nicole, rhythm→af_james, bookkeeper/sage→bf_emma. |
 | GET | `/canvas/activity-stream` | **Canvas activity SSE** — replays last 20 canvas events on connect (event: `backfill`, includes `_staggerMs` hint for animated replay at 50ms intervals), then streams live events (event: `activity`). Event types: canvas_message, canvas_render, canvas_expression, canvas_burst. `backfill_done` event signals replay complete. Canvas feels alive from frame 1. |
 | GET | `/canvas/attention` | **Single highest-priority attention item** for the canvas viewer. Query: `?viewer=human` (default). Returns `{ item: { source, priority, title, detail?, taskId?, prUrl?, agentId?, actionLabel, actionType, notificationId? } \| null, pendingCount: number }`. Priority order: critical/high notifications → validating tasks needing review → blocked tasks → remaining notifications. |
 | GET | `/canvas/pulse` | SSE stream emitting a heartbeat tick every 2s. Also emits real-time named events: `canvas_burst` (dramatic state transitions), `canvas_spark` (agent arcs), `canvas_milestone` (task_complete/pr_merged — the room exhaling), `canvas_message` (query response cards), `canvas_push` (agent proactive emissions). Connect once, animate forever. Tick shape: `{ t, agents: [{ id, state, urgency, activeSpeaker, color, age }], team: { rhythm, tension, ambientPulse, dominantColor } }`. |
 | POST | `/canvas/push` | **Proactive canvas** — agent self-initiates a canvas event without a human query. Types: `utterance` (text floats from orb, max 60 chars, default TTL 4000ms), `work_released` (release pulse when work ships, intensity 0–1), `handoff` (arc between agents when work moves, requires `toAgentId`), `canvas_response` (agent responds to a canvas query with a structured card — requires `card` object with `type` field, optional `query` string; also emits `canvas_message` for living-canvas rendering), `rich` (arbitrary visual content — agents paint the canvas with markdown, code, images, SVG, or HTML; requires `content` object with any of: `markdown`, `code`, `language`, `image` (URL), `svg`, `html`, `title`; optional `position: {x,y}`, `layer: foreground\|midground\|background`, `size: {w,h}`, `ttl` up to 120s default 30s). All types emit `canvas_push` on the pulse SSE stream. Body: `{ type, agentId, text?, ttl?, intensity?, toAgentId?, taskTitle?, card?, query?, content?, position?, layer?, size? }`. |
+| POST | `/canvas/welcome` | **First-wow auto-welcome** — triggers an immediate greeting when a visitor loads the canvas. Selects a random active agent, creates a welcome task assigned to them, and emits a canvas push greeting. Agents have personalized greetings. Also emits `canvas_first_action` activation event. Returns `{ success, agentId, greeting, taskId }`. |
 | POST | `/canvas/artifact` | **Proof artifact stream** — emit a proof card that drifts through the canvas. Types: `commit`, `pr`, `test`, `run`, `approval`. Also fires automatically on task completion (approval type) and PR merge (pr type) via `/canvas/victory`. Payload: `{ type, agentId, title (max 80 chars), url?, taskId? }`. Emits `canvas_artifact` event on pulse SSE. |
 | POST | `/canvas/victory` | **The Victory** — whole team acknowledges a PR merge. Fires `canvas_expression { _victory: true }` (gold flash + celebration + resolve sound) then a `_victoryWave` per active agent staggered 350ms apart. Body: `{ prUrl, agentId, prTitle?, prNumber?, intensity? }`. Returns: `{ success, prNumber, intensity, wave: [{ agentId, delay }] }`. |
 | GET | `/canvas/flow-score` | **Team flow metric** — real-time 0–1 composite score. Factors: active agents (30%), state distribution (35%), expression velocity last 5m (25%), time of day (10%). Labels: surge/flow/grinding/quiet/idle. <50ms. Returns: `{ score, label, factors, activeAgents, expressionsLast5m }`. |

package/dist/agent-config.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=agent-config.test.d.ts.map

package/dist/agent-config.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-config.test.d.ts","sourceRoot":"","sources":["../src/agent-config.test.ts"],"names":[],"mappings":""}

package/dist/agent-config.test.js

@@ -1,91 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-// Test the cost cap logic in isolation
-function checkCostCap(config, dailySpend, monthlySpend) {
-    if (!config)
-        return { allowed: true, action: 'allow' };
-    let action = 'allow';
-    if (config.costCapDaily !== null) {
-        const remaining = config.costCapDaily - dailySpend;
-        if (remaining <= 0)
-            action = 'deny';
-        else if (remaining < config.costCapDaily * 0.1)
-            action = 'downgrade';
-        else if (remaining < config.costCapDaily * 0.2)
-            action = 'warn';
-    }
-    if (config.costCapMonthly !== null) {
-        const remaining = config.costCapMonthly - monthlySpend;
-        if (remaining <= 0)
-            action = 'deny';
-        else if (remaining < config.costCapMonthly * 0.1 && action !== 'deny')
-            action = 'downgrade';
-        else if (remaining < config.costCapMonthly * 0.2 && action === 'allow')
-            action = 'warn';
-    }
-    return { allowed: action !== 'deny', action };
-}
-describe('agent config cost enforcement', () => {
-    it('allows when no config exists', () => {
-        const r = checkCostCap(null, 5, 50);
-        assert.equal(r.allowed, true);
-        assert.equal(r.action, 'allow');
-    });
-    it('allows when no caps are set', () => {
-        const r = checkCostCap({ costCapDaily: null, costCapMonthly: null, model: null, fallbackModel: null }, 5, 50);
-        assert.equal(r.allowed, true);
-        assert.equal(r.action, 'allow');
-    });
-    it('allows when well under daily cap', () => {
-        const r = checkCostCap({ costCapDaily: 10, costCapMonthly: null, model: 'opus', fallbackModel: 'sonnet' }, 3, 0);
-        assert.equal(r.allowed, true);
-        assert.equal(r.action, 'allow');
-    });
-    it('warns at 80% daily spend', () => {
-        const r = checkCostCap({ costCapDaily: 10, costCapMonthly: null, model: 'opus', fallbackModel: 'sonnet' }, 8.5, 0);
-        assert.equal(r.allowed, true);
-        assert.equal(r.action, 'warn');
-    });
-    it('downgrades at 90% daily spend', () => {
-        const r = checkCostCap({ costCapDaily: 10, costCapMonthly: null, model: 'opus', fallbackModel: 'sonnet' }, 9.5, 0);
-        assert.equal(r.allowed, true);
-        assert.equal(r.action, 'downgrade');
-    });
-    it('denies at 100% daily spend', () => {
-        const r = checkCostCap({ costCapDaily: 10, costCapMonthly: null, model: 'opus', fallbackModel: 'sonnet' }, 10, 0);
-        assert.equal(r.allowed, false);
-        assert.equal(r.action, 'deny');
-    });
-    it('denies when over daily cap', () => {
-        const r = checkCostCap({ costCapDaily: 10, costCapMonthly: null, model: 'opus', fallbackModel: 'sonnet' }, 12, 0);
-        assert.equal(r.allowed, false);
-        assert.equal(r.action, 'deny');
-    });
-    it('monthly cap denies overriding daily allow', () => {
-        const r = checkCostCap({ costCapDaily: 10, costCapMonthly: 100, model: null, fallbackModel: null }, 3, 100);
-        assert.equal(r.allowed, false);
-        assert.equal(r.action, 'deny');
-    });
-    it('monthly warn when daily is fine', () => {
-        const r = checkCostCap({ costCapDaily: null, costCapMonthly: 100, model: null, fallbackModel: null }, 0, 85);
-        assert.equal(r.allowed, true);
-        assert.equal(r.action, 'warn');
-    });
-    it('monthly downgrade at 90%', () => {
-        const r = checkCostCap({ costCapDaily: null, costCapMonthly: 100, model: null, fallbackModel: null }, 0, 95);
-        assert.equal(r.allowed, true);
-        assert.equal(r.action, 'downgrade');
-    });
-    it('both caps — tighter one wins', () => {
-        // Daily is at 95% (downgrade), monthly is fine
-        const r = checkCostCap({ costCapDaily: 10, costCapMonthly: 1000, model: 'opus', fallbackModel: 'sonnet' }, 9.5, 50);
-        assert.equal(r.action, 'downgrade');
-    });
-    it('zero cap always denies', () => {
-        const r = checkCostCap({ costCapDaily: 0, costCapMonthly: null, model: null, fallbackModel: null }, 0, 0);
-        assert.equal(r.allowed, false);
-        assert.equal(r.action, 'deny');
-    });
-});
-//# sourceMappingURL=agent-config.test.js.map

package/dist/agent-config.test.js.map

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

package/dist/agent-exec-guardrail.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=agent-exec-guardrail.test.d.ts.map

package/dist/agent-exec-guardrail.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-exec-guardrail.test.d.ts","sourceRoot":"","sources":["../src/agent-exec-guardrail.test.ts"],"names":[],"mappings":""}

package/dist/agent-exec-guardrail.test.js

@@ -1,55 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { checkActionAllowed, requiresApprovalGate } from './agent-exec-guardrail.js';
-describe('checkActionAllowed', () => {
-    it('allows github_issue_create with github.com domain', () => {
-        const result = checkActionAllowed('github_issue_create', 'https://github.com/owner/repo');
-        assert.equal(result.allowed, true);
-        assert.equal(result.reason, undefined);
-    });
-    it('allows github_issue_create with no target', () => {
-        const result = checkActionAllowed('github_issue_create');
-        assert.equal(result.allowed, true);
-    });
-    it('denies unknown action with reason', () => {
-        // @ts-expect-error testing unknown kind
-        const result = checkActionAllowed('unknown_action');
-        assert.equal(result.allowed, false);
-        assert.ok(result.reason?.includes('unknown_action'));
-        assert.ok(result.reason?.includes('approved action list'));
-    });
-    it('denies out-of-scope domain with reason', () => {
-        const result = checkActionAllowed('github_issue_create', 'https://evil.com/owner/repo');
-        assert.equal(result.allowed, false);
-        assert.ok(result.reason?.includes('evil.com'));
-        assert.ok(result.reason?.includes('approved domain list'));
-    });
-    it('allows subdomain of github.com', () => {
-        const result = checkActionAllowed('github_issue_create', 'https://api.github.com/repos/owner/repo/issues');
-        assert.equal(result.allowed, true);
-    });
-    it('does not match partial domain (githubx.com)', () => {
-        const result = checkActionAllowed('github_issue_create', 'https://githubx.com/owner/repo');
-        assert.equal(result.allowed, false);
-        assert.ok(result.reason?.includes('githubx.com'));
-    });
-    it('ignores non-URL target strings (no hostname to check)', () => {
-        // If target is not a URL, URL parsing returns null and no domain check is done
-        const result = checkActionAllowed('github_issue_create', 'owner/repo');
-        assert.equal(result.allowed, true);
-    });
-});
-describe('requiresApprovalGate', () => {
-    it('returns true for github_issue_create', () => {
-        assert.equal(requiresApprovalGate('github_issue_create'), true);
-    });
-    it('returns true for all v1 actions (always requires human approval)', () => {
-        // All v1 actions are irreversible — gate is always on
-        const kinds = ['github_issue_create'];
-        for (const kind of kinds) {
-            assert.equal(requiresApprovalGate(kind), true);
-        }
-    });
-});
-//# sourceMappingURL=agent-exec-guardrail.test.js.map

package/dist/agent-exec-guardrail.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-exec-guardrail.test.js","sourceRoot":"","sources":["../src/agent-exec-guardrail.test.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEpF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,kBAAkB,CAAC,qBAAqB,EAAE,+BAA+B,CAAC,CAAA;QACzF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAClC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,kBAAkB,CAAC,qBAAqB,CAAC,CAAA;QACxD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,wCAAwC;QACxC,MAAM,MAAM,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACnC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAA;QACpD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,kBAAkB,CAAC,qBAAqB,EAAE,6BAA6B,CAAC,CAAA;QACvF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACnC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;QAC9C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,kBAAkB,CAAC,qBAAqB,EAAE,gDAAgD,CAAC,CAAA;QAC1G,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,kBAAkB,CAAC,qBAAqB,EAAE,gCAAgC,CAAC,CAAA;QAC1F,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACnC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,+EAA+E;QAC/E,MAAM,MAAM,GAAG,kBAAkB,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAA;QACtE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,sDAAsD;QACtD,MAAM,KAAK,GAAG,CAAC,qBAAqB,CAAU,CAAA;QAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;QAChD,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/agent-memories.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=agent-memories.test.d.ts.map

package/dist/agent-memories.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-memories.test.d.ts","sourceRoot":"","sources":["../src/agent-memories.test.ts"],"names":[],"mappings":""}