reflectt-node 0.1.14 → 0.1.16

package/dist/canvas-routes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Canvas Routes (Phase 1) — extracted from server.ts
+ *
+ * Fastify plugin that registers a first batch of /canvas/* endpoints.
+ * Each extracted route is replaced with this plugin in server.ts.
+ * Remaining routes stay in server.ts for Phase 2+ extraction.
+ *
+ * Extraction strategy: start with simple, self-contained routes.
+ * Complex routes with deep state coupling remain in server.ts.
+ *
+ * task-1773681272865
+ */
+import type { FastifyInstance } from 'fastify';
+export type CanvasState = 'floor' | 'ambient' | 'thinking' | 'rendering' | 'decision' | 'handoff' | 'urgent' | 'presenting';
+export interface CanvasStateEntry {
+    state: CanvasState;
+    sensors: string | null;
+    payload: unknown;
+    updatedAt: number;
+}
+/**
+ * Dependencies injected from server.ts.
+ * Each dep is a narrow interface — no coupling to the full module.
+ */
+export interface CanvasRouteDeps {
+    canvasSlots: {
+        getActive: () => unknown[];
+        getAll: () => unknown[];
+        getStats: () => unknown;
+    };
+    getRecentRejections: () => unknown[];
+}
+export declare const CANVAS_STATES: string[];
+export declare const SENSOR_VALUES: string[];
+export declare function canvasReadRoutes(app: FastifyInstance, deps: CanvasRouteDeps): Promise<void>;
+//# sourceMappingURL=canvas-routes.d.ts.map

package/dist/canvas-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-routes.d.ts","sourceRoot":"","sources":["../src/canvas-routes.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAK9C,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAA;AAE3H,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,OAAO,EAAE,CAAA;QAC1B,MAAM,EAAE,MAAM,OAAO,EAAE,CAAA;QACvB,QAAQ,EAAE,MAAM,OAAO,CAAA;KACxB,CAAA;IACD,mBAAmB,EAAE,MAAM,OAAO,EAAE,CAAA;CACrC;AAID,eAAO,MAAM,aAAa,UAEzB,CAAA;AACD,eAAO,MAAM,aAAa,UAEzB,CAAA;AAID,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,iBAsCjF"}

package/dist/canvas-routes.js

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+import { emitActivationEvent } from './activationEvents.js';
+// ── Constants (moved from server.ts) ──
+export const CANVAS_STATES = [
+    'floor', 'listening', 'thinking', 'rendering', 'ambient', 'decision', 'urgent', 'handoff', 'presenting',
+];
+export const SENSOR_VALUES = [
+    'voice_active', 'screen_share', 'camera', 'typing', 'idle', 'scroll', 'hover', 'focus',
+];
+// ── Plugin ──
+export async function canvasReadRoutes(app, deps) {
+    // GET /canvas/states — valid state + sensor values (discovery)
+    app.get('/canvas/states', async (request) => {
+        const query = request.query;
+        const userId = typeof query.userId === 'string' && query.userId.trim()
+            ? query.userId.trim()
+            : 'anonymous';
+        emitActivationEvent('canvas_opened', userId).catch(() => { });
+        return ({
+            states: CANVAS_STATES,
+            sensors: SENSOR_VALUES,
+            schema: {
+                state: 'floor | listening | thinking | rendering | ambient | decision | urgent | handoff',
+                sensors: 'null | mic | camera | mic+camera (non-dismissable trust indicator)',
+                agentId: 'required — which agent is driving the canvas',
+                payload: 'optional — text, media, decision, agents, summary',
+            },
+        });
+    });
+    // GET /canvas/slots — current active slots
+    app.get('/canvas/slots', async () => {
+        return {
+            slots: deps.canvasSlots.getActive(),
+            stats: deps.canvasSlots.getStats(),
+        };
+    });
+    // GET /canvas/slots/all — all slots including stale (debug)
+    app.get('/canvas/slots/all', async () => {
+        return { slots: deps.canvasSlots.getAll() };
+    });
+    // GET /canvas/rejections — recent render rejections (debug)
+    app.get('/canvas/rejections', async () => {
+        return { rejections: deps.getRecentRejections() };
+    });
+}
+//# sourceMappingURL=canvas-routes.js.map

package/dist/canvas-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-routes.js","sourceRoot":"","sources":["../src/canvas-routes.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4BAA4B;AAgB5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AA0B3D,yCAAyC;AAEzC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY;CACxG,CAAA;AACD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO;CACvF,CAAA;AAED,eAAe;AAEf,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAoB,EAAE,IAAqB;IAEhF,+DAA+D;IAC/D,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAgC,CAAA;QACtD,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;YACpE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;YACrB,CAAC,CAAC,WAAW,CAAA;QACf,mBAAmB,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC5D,OAAO,CAAC;YACR,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE;gBACN,KAAK,EAAE,kFAAkF;gBACzF,OAAO,EAAE,oEAAoE;gBAC7E,OAAO,EAAE,8CAA8C;gBACvD,OAAO,EAAE,mDAAmD;aAC7D;SACF,CAAC,CAAA;IACF,CAAC,CAAC,CAAA;IAEF,2CAA2C;IAC3C,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;QAClC,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE;YACnC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE;SACnC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,4DAA4D;IAC5D,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QACtC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,4DAA4D;IAC5D,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;QACvC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAA;IACnD,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/capability-readiness.d.ts

@@ -0,0 +1,28 @@
+export type ReadinessStatus = 'ready' | 'degraded' | 'not_ready' | 'unknown';
+export interface CapabilityReadiness {
+    capability: string;
+    status: ReadinessStatus;
+    last_success_at: number | null;
+    last_error: string | null;
+    dependencies: DependencyCheck[];
+    hint: string | null;
+}
+export interface DependencyCheck {
+    name: string;
+    status: 'ok' | 'missing' | 'error';
+    detail?: string;
+}
+export interface ReadinessReport {
+    overall: ReadinessStatus;
+    capabilities: CapabilityReadiness[];
+    checked_at: number;
+}
+export declare function getCapabilityReadiness(opts: {
+    cloudConnected: boolean;
+    cloudUrl: string;
+    webhooks: Array<{
+        provider: string;
+        active: boolean;
+    }>;
+}): ReadinessReport;
+//# sourceMappingURL=capability-readiness.d.ts.map

package/dist/capability-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-readiness.d.ts","sourceRoot":"","sources":["../src/capability-readiness.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAA;AAE5E,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,eAAe,CAAA;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,eAAe,EAAE,CAAA;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,CAAA;IACxB,YAAY,EAAE,mBAAmB,EAAE,CAAA;IACnC,UAAU,EAAE,MAAM,CAAA;CACnB;AAsKD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,cAAc,EAAE,OAAO,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CACvD,GAAG,eAAe,CAgBlB"}

package/dist/capability-readiness.js

@@ -0,0 +1,162 @@
+// SPDX-License-Identifier: Apache-2.0
+// Capability readiness contract — per-capability status with dependency checks.
+// Powers GET /capabilities/readiness and cloud UI badges.
+// ── Browser ──────────────────────────────────────────────────────────────────
+function checkBrowserReadiness() {
+    const deps = [];
+    const errors = [];
+    // Check if Stagehand package is available
+    try {
+        require.resolve('@browserbasehq/stagehand');
+        deps.push({ name: 'stagehand_package', status: 'ok' });
+    }
+    catch {
+        deps.push({ name: 'stagehand_package', status: 'missing', detail: '@browserbasehq/stagehand not installed' });
+        errors.push('Stagehand package not installed');
+    }
+    // Check for ANTHROPIC_API_KEY or OPENAI_API_KEY (required by Stagehand)
+    const hasAnthropicKey = !!(process.env.ANTHROPIC_API_KEY);
+    const hasOpenAIKey = !!(process.env.OPENAI_API_KEY);
+    if (hasAnthropicKey || hasOpenAIKey) {
+        deps.push({ name: 'llm_api_key', status: 'ok', detail: hasAnthropicKey ? 'ANTHROPIC_API_KEY set' : 'OPENAI_API_KEY set' });
+    }
+    else {
+        deps.push({ name: 'llm_api_key', status: 'missing', detail: 'ANTHROPIC_API_KEY or OPENAI_API_KEY required for Stagehand' });
+        errors.push('LLM API key missing (ANTHROPIC_API_KEY or OPENAI_API_KEY)');
+    }
+    // Check BROWSERBASE_API_KEY (optional — cloud browser)
+    const hasBrowserbaseKey = !!(process.env.BROWSERBASE_API_KEY);
+    deps.push({
+        name: 'browserbase_api_key',
+        status: hasBrowserbaseKey ? 'ok' : 'missing',
+        detail: hasBrowserbaseKey ? 'BROWSERBASE_API_KEY set' : 'Optional — uses local browser if absent',
+    });
+    const status = errors.length === 0 ? 'ready'
+        : errors.some(e => e.includes('package')) ? 'not_ready'
+            : 'degraded';
+    return {
+        capability: 'browser',
+        status,
+        last_success_at: null,
+        last_error: errors.length > 0 ? errors[0] : null,
+        dependencies: deps,
+        hint: status !== 'ready'
+            ? 'Install @browserbasehq/stagehand and set ANTHROPIC_API_KEY to enable browser automation.'
+            : null,
+    };
+}
+// ── Email ─────────────────────────────────────────────────────────────────────
+function checkEmailReadiness(cloudConnected, cloudUrl, webhooks) {
+    const deps = [];
+    const errors = [];
+    // Cloud connection required for relay
+    deps.push({
+        name: 'cloud_connection',
+        status: cloudConnected ? 'ok' : 'missing',
+        detail: cloudConnected ? `Connected to ${cloudUrl}` : 'Not enrolled with Reflectt Cloud',
+    });
+    if (!cloudConnected)
+        errors.push('Cloud connection required for email relay');
+    // Check inbound webhook route (resend)
+    const resendWebhook = webhooks.find(w => w.provider === 'resend' && w.active);
+    deps.push({
+        name: 'inbound_webhook',
+        status: resendWebhook ? 'ok' : 'missing',
+        detail: resendWebhook ? 'Resend inbound webhook active' : 'No active Resend inbound webhook configured',
+    });
+    if (!resendWebhook)
+        errors.push('Resend inbound webhook not configured — replies will not be received');
+    const status = errors.length === 0 ? 'ready'
+        : !cloudConnected ? 'not_ready'
+            : 'degraded';
+    return {
+        capability: 'email',
+        status,
+        last_success_at: null,
+        last_error: errors.length > 0 ? errors[0] : null,
+        dependencies: deps,
+        hint: status !== 'ready'
+            ? !cloudConnected
+                ? 'Enroll this host with Reflectt Cloud to enable email relay.'
+                : 'Configure a Resend inbound webhook via POST /provisioning/webhooks to receive replies.'
+            : null,
+    };
+}
+// ── SMS ───────────────────────────────────────────────────────────────────────
+function checkSmsReadiness(cloudConnected, cloudUrl, webhooks) {
+    const deps = [];
+    const errors = [];
+    deps.push({
+        name: 'cloud_connection',
+        status: cloudConnected ? 'ok' : 'missing',
+        detail: cloudConnected ? `Connected to ${cloudUrl}` : 'Not enrolled with Reflectt Cloud',
+    });
+    if (!cloudConnected)
+        errors.push('Cloud connection required for SMS relay');
+    // Check for Twilio inbound webhook route
+    const twilioWebhook = webhooks.find(w => (w.provider === 'twilio' || w.provider === 'sms') && w.active);
+    deps.push({
+        name: 'inbound_webhook',
+        status: twilioWebhook ? 'ok' : 'missing',
+        detail: twilioWebhook ? 'SMS inbound webhook active' : 'No active SMS inbound webhook configured',
+    });
+    if (!twilioWebhook)
+        errors.push('SMS inbound webhook not configured — replies will not be received');
+    const status = errors.length === 0 ? 'ready'
+        : !cloudConnected ? 'not_ready'
+            : 'degraded';
+    return {
+        capability: 'sms',
+        status,
+        last_success_at: null,
+        last_error: errors.length > 0 ? errors[0] : null,
+        dependencies: deps,
+        hint: status !== 'ready'
+            ? !cloudConnected
+                ? 'Enroll this host with Reflectt Cloud to enable SMS relay.'
+                : 'Configure a Twilio inbound webhook via POST /provisioning/webhooks to receive SMS replies.'
+            : null,
+    };
+}
+// ── Calendar ──────────────────────────────────────────────────────────────────
+function checkCalendarReadiness() {
+    const deps = [];
+    const errors = [];
+    // Calendar is always locally available (no external deps required for basic scheduling)
+    deps.push({ name: 'calendar_module', status: 'ok', detail: 'Local calendar storage active' });
+    // Optional: Google Calendar sync env var
+    const hasGoogleCal = !!(process.env.GOOGLE_CALENDAR_CLIENT_ID && process.env.GOOGLE_CALENDAR_CLIENT_SECRET);
+    deps.push({
+        name: 'google_calendar_sync',
+        status: hasGoogleCal ? 'ok' : 'missing',
+        detail: hasGoogleCal
+            ? 'Google Calendar credentials configured'
+            : 'Optional — GOOGLE_CALENDAR_CLIENT_ID + GOOGLE_CALENDAR_CLIENT_SECRET for sync',
+    });
+    // iCal import is always available
+    deps.push({ name: 'ical_import', status: 'ok', detail: 'iCal import/export available' });
+    return {
+        capability: 'calendar',
+        status: errors.length === 0 ? 'ready' : 'degraded',
+        last_success_at: null,
+        last_error: errors.length > 0 ? errors[0] : null,
+        dependencies: deps,
+        hint: null,
+    };
+}
+// ── Main readiness check ──────────────────────────────────────────────────────
+export function getCapabilityReadiness(opts) {
+    const capabilities = [
+        checkBrowserReadiness(),
+        checkEmailReadiness(opts.cloudConnected, opts.cloudUrl, opts.webhooks),
+        checkSmsReadiness(opts.cloudConnected, opts.cloudUrl, opts.webhooks),
+        checkCalendarReadiness(),
+    ];
+    // Overall: ready if all ready, degraded if any degraded, not_ready if any not_ready
+    const overall = capabilities.some(c => c.status === 'not_ready') ? 'not_ready'
+        : capabilities.some(c => c.status === 'degraded') ? 'degraded'
+            : capabilities.every(c => c.status === 'ready') ? 'ready'
+                : 'unknown';
+    return { overall, capabilities, checked_at: Date.now() };
+}
+//# sourceMappingURL=capability-readiness.js.map

package/dist/capability-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-readiness.js","sourceRoot":"","sources":["../src/capability-readiness.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gFAAgF;AAChF,0DAA0D;AAyB1D,gFAAgF;AAEhF,SAAS,qBAAqB;IAC5B,MAAM,IAAI,GAAsB,EAAE,CAAA;IAClC,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,0CAA0C;IAC1C,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAA;QAC3C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,wCAAwC,EAAE,CAAC,CAAA;QAC7G,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;IAChD,CAAC;IAED,wEAAwE;IACxE,MAAM,eAAe,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;IACzD,MAAM,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IACnD,IAAI,eAAe,IAAI,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAA;IAC5H,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,4DAA4D,EAAE,CAAC,CAAA;QAC3H,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAA;IAC1E,CAAC;IAED,uDAAuD;IACvD,MAAM,iBAAiB,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;IAC7D,IAAI,CAAC,IAAI,CAAC;QACR,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC5C,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,yCAAyC;KAClG,CAAC,CAAA;IAEF,MAAM,MAAM,GAAoB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO;QAC3D,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;YACvD,CAAC,CAAC,UAAU,CAAA;IAEd,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,MAAM;QACN,eAAe,EAAE,IAAI;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAChD,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,MAAM,KAAK,OAAO;YACtB,CAAC,CAAC,0FAA0F;YAC5F,CAAC,CAAC,IAAI;KACT,CAAA;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAS,mBAAmB,CAAC,cAAuB,EAAE,QAAgB,EAAE,QAAsD;IAC5H,MAAM,IAAI,GAAsB,EAAE,CAAA;IAClC,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,sCAAsC;IACtC,IAAI,CAAC,IAAI,CAAC;QACR,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACzC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC,CAAC,kCAAkC;KACzF,CAAC,CAAA;IACF,IAAI,CAAC,cAAc;QAAE,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;IAE7E,uCAAuC;IACvC,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;IAC7E,IAAI,CAAC,IAAI,CAAC;QACR,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACxC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,6CAA6C;KACxG,CAAC,CAAA;IACF,IAAI,CAAC,aAAa;QAAE,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAA;IAEvG,MAAM,MAAM,GAAoB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO;QAC3D,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW;YAC/B,CAAC,CAAC,UAAU,CAAA;IAEd,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,MAAM;QACN,eAAe,EAAE,IAAI;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAChD,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,MAAM,KAAK,OAAO;YACtB,CAAC,CAAC,CAAC,cAAc;gBACf,CAAC,CAAC,6DAA6D;gBAC/D,CAAC,CAAC,wFAAwF;YAC5F,CAAC,CAAC,IAAI;KACT,CAAA;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAS,iBAAiB,CAAC,cAAuB,EAAE,QAAgB,EAAE,QAAsD;IAC1H,MAAM,IAAI,GAAsB,EAAE,CAAA;IAClC,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,IAAI,CAAC,IAAI,CAAC;QACR,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACzC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC,CAAC,kCAAkC;KACzF,CAAC,CAAA;IACF,IAAI,CAAC,cAAc;QAAE,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAA;IAE3E,yCAAyC;IACzC,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;IACvG,IAAI,CAAC,IAAI,CAAC;QACR,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACxC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,0CAA0C;KAClG,CAAC,CAAA;IACF,IAAI,CAAC,aAAa;QAAE,MAAM,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAA;IAEpG,MAAM,MAAM,GAAoB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO;QAC3D,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW;YAC/B,CAAC,CAAC,UAAU,CAAA;IAEd,OAAO;QACL,UAAU,EAAE,KAAK;QACjB,MAAM;QACN,eAAe,EAAE,IAAI;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAChD,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,MAAM,KAAK,OAAO;YACtB,CAAC,CAAC,CAAC,cAAc;gBACf,CAAC,CAAC,2DAA2D;gBAC7D,CAAC,CAAC,4FAA4F;YAChG,CAAC,CAAC,IAAI;KACT,CAAA;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAS,sBAAsB;IAC7B,MAAM,IAAI,GAAsB,EAAE,CAAA;IAClC,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,wFAAwF;IACxF,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC,CAAA;IAE7F,yCAAyC;IACzC,MAAM,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;IAC3G,IAAI,CAAC,IAAI,CAAC;QACR,IAAI,EAAE,sBAAsB;QAC5B,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACvC,MAAM,EAAE,YAAY;YAClB,CAAC,CAAC,wCAAwC;YAC1C,CAAC,CAAC,+EAA+E;KACpF,CAAC,CAAA;IAEF,kCAAkC;IAClC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC,CAAA;IAExF,OAAO;QACL,UAAU,EAAE,UAAU;QACtB,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;QAClD,eAAe,EAAE,IAAI;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAChD,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,IAAI;KACX,CAAA;AACH,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,sBAAsB,CAAC,IAItC;IACC,MAAM,YAAY,GAAG;QACnB,qBAAqB,EAAE;QACvB,mBAAmB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;QACtE,iBAAiB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;QACpE,sBAAsB,EAAE;KACzB,CAAA;IAED,oFAAoF;IACpF,MAAM,OAAO,GACX,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW;QAC9D,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU;YAC9D,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;gBACzD,CAAC,CAAC,SAAS,CAAA;IAEb,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;AAC1D,CAAC"}

package/dist/channels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAUtB,CAAA;AAEV,eAAO,MAAM,qBAAqB,gGAAiD,CAAA;AAEnF,eAAO,MAAM,2BAA2B,UAOvC,CAAA"}
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAUtB,CAAA;AAEV,eAAO,MAAM,qBAAqB,gGAAiD,CAAA;AAEnF,eAAO,MAAM,2BAA2B,UAQvC,CAAA"}

package/dist/channels.js

@@ -14,6 +14,7 @@ export const CHANNEL_DEFINITIONS = [
 export const DEFAULT_CHAT_CHANNELS = CHANNEL_DEFINITIONS.map(channel => channel.id);
 export const DEFAULT_INBOX_SUBSCRIPTIONS = [
     'general',
+    'canvas',
     'decisions',
     'shipping',
     'reviews',

package/dist/channels.js.map

@@ -1 +1 @@
-{"version":3,"file":"channels.js","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4BAA4B;AAE5B,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE;IACtC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;IACpC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;IACpC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IAC1B,wEAAwE;IACxE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAC5C,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE;CAC1B,CAAA;AAEV,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;AAEnF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,SAAS;IACT,WAAW;IACX,UAAU;IACV,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAA"}
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4BAA4B;AAE5B,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE;IACtC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;IACpC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;IACpC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IAC1B,wEAAwE;IACxE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAC5C,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE;CAC1B,CAAA;AAEV,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;AAEnF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,SAAS;IACT,QAAQ;IACR,WAAW;IACX,UAAU;IACV,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAA"}

package/dist/cli.js

@@ -114,10 +114,105 @@ function buildServerEnv(config) {
     }
     return env;
 }
-function startServerDetached(config) {
+/**
+ * Check if dist/ is stale compared to src/ (i.e. source files were modified after last build).
+ * Returns a warning message if stale, or null if fresh.
+ */
+function checkBuildFreshness() {
+    const __filename = fileURLToPath(import.meta.url);
+    const projectRoot = join(dirname(__filename), '..');
+    const distDir = join(projectRoot, 'dist');
+    const srcDir = join(projectRoot, 'src');
+    if (!existsSync(distDir)) {
+        return `❌ Build output missing: ${distDir} does not exist. Run 'npm run build' before starting.`;
+    }
+    const distIndex = join(distDir, 'server.js');
+    if (!existsSync(distIndex)) {
+        return `❌ Build output incomplete: dist/server.js not found. Run 'npm run build' before starting.`;
+    }
+    try {
+        const distMtime = statSync(distIndex).mtimeMs;
+        // Check a few key source files — if any are newer than dist, build is stale
+        const checkFiles = ['server.ts', 'cli.ts', 'config.ts', 'chat.ts'];
+        for (const file of checkFiles) {
+            const srcFile = join(srcDir, file);
+            if (existsSync(srcFile)) {
+                const srcMtime = statSync(srcFile).mtimeMs;
+                if (srcMtime > distMtime) {
+                    return `⚠️  Build may be stale: src/${file} is newer than dist/server.js. Run 'npm run build' to rebuild.`;
+                }
+            }
+        }
+    }
+    catch {
+        // If stat fails, don't block startup
+    }
+    return null;
+}
+/**
+ * Auto-rebuild dist/ when stale or missing.
+ * Returns true if rebuild succeeded, false if it failed.
+ */
+function autoRebuild(projectRoot) {
+    console.log('🔨 Build is stale or missing — auto-rebuilding...');
+    try {
+        execSync('npm run build', { cwd: projectRoot, stdio: 'inherit', timeout: 60_000 });
+        console.log('✅ Build complete');
+        return true;
+    }
+    catch (err) {
+        console.error('❌ Auto-rebuild failed:', err.message);
+        return false;
+    }
+}
+function startServerDetached(config, forceTsx = false) {
     const { projectRoot, serverPath, useNode } = getRuntimePaths();
+    // --tsx flag: always use tsx, skip dist entirely
+    if (forceTsx) {
+        const tsxPath = join(projectRoot, 'src', 'index.ts');
+        if (!existsSync(tsxPath)) {
+            throw new Error(`Source file not found: ${tsxPath}`);
+        }
+        const child = spawn('npx', ['tsx', tsxPath], {
+            env: buildServerEnv(config),
+            detached: true,
+            stdio: 'ignore',
+            cwd: projectRoot,
+        });
+        child.unref();
+        writeFileSync(PID_FILE, String(child.pid));
+        return child.pid;
+    }
     if (!existsSync(serverPath)) {
-        throw new Error(`Server file not found: ${serverPath}`);
+        // Try auto-rebuild before giving up
+        if (useNode && autoRebuild(projectRoot)) {
+            // Re-check after rebuild
+            if (!existsSync(serverPath)) {
+                throw new Error(`Server file still not found after rebuild: ${serverPath}`);
+            }
+        }
+        else if (useNode) {
+            throw new Error(`Server file not found: ${serverPath}. Auto-rebuild failed.`);
+        }
+        else {
+            throw new Error(`Server file not found: ${serverPath}`);
+        }
+    }
+    // Check build freshness for compiled mode — auto-rebuild if stale
+    if (useNode) {
+        const warning = checkBuildFreshness();
+        if (warning) {
+            if (warning.startsWith('❌') || warning.startsWith('⚠️')) {
+                if (!autoRebuild(projectRoot)) {
+                    console.warn(warning);
+                    if (warning.startsWith('❌')) {
+                        throw new Error('Cannot start: build output is missing and auto-rebuild failed.');
+                    }
+                    // Stale warning but rebuild failed — continue with stale dist and warn
+                    console.warn('⚠️  Continuing with potentially stale build');
+                }
+            }
+        }
     }
     const cmd = useNode ? 'node' : 'npx';
     const args = useNode ? [serverPath] : ['tsx', serverPath];
@@ -488,6 +583,7 @@ program
     .command('start')
     .description('Start the reflectt server')
     .option('-d, --detach', 'Run in background')
+    .option('--tsx', 'Use tsx (TypeScript) directly — no build step needed')
     .action(async (options) => {
     if (!existsSync(REFLECTT_HOME)) {
         console.log('📦 First run — initializing reflectt...');
@@ -545,9 +641,88 @@ program
         // Port not responding — safe to start
     }
     const { projectRoot, serverPath, useNode } = getRuntimePaths();
+    // --tsx flag: always use tsx, skip dist entirely
+    if (options.tsx) {
+        const tsxPath = join(projectRoot, 'src', 'index.ts');
+        if (!existsSync(tsxPath)) {
+            console.error(`❌ Source file not found: ${tsxPath}`);
+            console.error('   --tsx requires a source checkout (not an npm install)');
+            process.exit(1);
+        }
+        if (options.detach) {
+            const pid = startServerDetached(config, true);
+            const clientHost2 = (config.host === '0.0.0.0' || config.host === '::') ? '127.0.0.1' : config.host;
+            console.log(`⏳ Starting reflectt server via tsx (PID: ${pid})...`);
+            let healthy = false;
+            for (let i = 0; i < 20; i++) {
+                await new Promise(r => setTimeout(r, 500));
+                try {
+                    const ctrl = new AbortController();
+                    const t = setTimeout(() => ctrl.abort(), 2000);
+                    const r = await fetch(`http://${clientHost2}:${config.port}/health`, { signal: ctrl.signal });
+                    clearTimeout(t);
+                    if (r.ok) {
+                        healthy = true;
+                        break;
+                    }
+                }
+                catch { /* not ready */ }
+            }
+            console.log(healthy ? '✅ Server is running (tsx mode)!' : '⚠️  Server started but not responding yet');
+            process.exit(0);
+        }
+        console.log('🚀 Starting reflectt server (tsx mode — no build step)...');
+        const env = buildServerEnv(config);
+        const child = spawn('npx', ['tsx', tsxPath], {
+            env,
+            stdio: 'inherit',
+            cwd: projectRoot,
+        });
+        child.on('exit', (code) => process.exit(code ?? 1));
+        return;
+    }
     if (!existsSync(serverPath)) {
-        console.error(`❌ Server file not found: ${serverPath}`);
-        process.exit(1);
+        // Auto-rebuild if dist is missing
+        if (useNode) {
+            console.log(`Server file not found: ${serverPath}`);
+            if (autoRebuild(projectRoot)) {
+                if (!existsSync(serverPath)) {
+                    console.error('❌ Build succeeded but server file still missing');
+                    process.exit(1);
+                }
+            }
+            else {
+                // Rebuild failed — try tsx fallback if source exists
+                const tsxFallback = join(projectRoot, 'src', 'index.ts');
+                if (existsSync(tsxFallback)) {
+                    console.log('💡 Falling back to tsx (source mode)...');
+                    const env = buildServerEnv(config);
+                    const child = spawn('npx', ['tsx', tsxFallback], {
+                        env,
+                        stdio: 'inherit',
+                        cwd: projectRoot,
+                    });
+                    child.on('exit', (code) => process.exit(code ?? 1));
+                    return;
+                }
+                console.error('❌ Cannot start: no dist/ and no src/. Is this a valid reflectt-node checkout?');
+                process.exit(1);
+            }
+        }
+        else {
+            console.error(`❌ Server file not found: ${serverPath}`);
+            process.exit(1);
+        }
+    }
+    // Auto-rebuild if stale
+    if (useNode) {
+        const warning = checkBuildFreshness();
+        if (warning && (warning.startsWith('❌') || warning.startsWith('⚠️'))) {
+            if (!autoRebuild(projectRoot)) {
+                console.warn(warning);
+                console.warn('⚠️  Continuing with potentially stale build');
+            }
+        }
     }
     const env = buildServerEnv(config);
     const cmd = useNode ? 'node' : 'npx';