@runcore-sh/runcore 0.1.8 → 0.1.10

package/dist/posture/engine.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Posture Engine — observes interaction patterns and adapts UI surface.
+ *
+ * The UI assembles itself around the user:
+ * - No interaction → silent mode, Core reaches out proactively
+ * - Light touches (pulse checks) → pulse mode
+ * - Deep dives (pages, agent logs, settings) → board mode
+ *
+ * Transitions happen automatically based on intent accumulation.
+ * The user can also pin a posture to lock it.
+ * Posture decays toward silent over time — if you stop looking, the UI fades.
+ */
+import type { PostureName, PostureState, PostureSurface, InteractionSignal } from "./types.js";
+/** Get current posture. */
+export declare function getPosture(): PostureName;
+/** Get current posture state (full details). */
+export declare function getPostureState(): PostureState;
+/** Get the surface map for the current posture. */
+export declare function getSurface(): PostureSurface;
+/** Check if a specific surface is available. */
+export declare function hasSurface(surface: keyof PostureSurface): boolean;
+/**
+ * Record an interaction signal. This is the primary input to the posture engine.
+ * Called by route handlers, middleware, or UI events.
+ */
+export declare function recordInteraction(signal: InteractionSignal): void;
+/**
+ * Pin the current posture — locks auto-transitions until unpinned.
+ * User explicitly chose this level. Respect it.
+ */
+export declare function pinPosture(posture: PostureName): void;
+/** Unpin — allow auto-transitions again. */
+export declare function unpinPosture(): void;
+/** Check for decay — called on a timer or at startup. */
+export declare function evaluateDecay(): void;
+/** Load posture state from brain/settings.json. */
+export declare function loadPosture(): Promise<void>;
+/** Start the decay check timer — runs hourly. */
+export declare function startDecayTimer(): void;
+export declare function stopDecayTimer(): void;
+//# sourceMappingURL=engine.d.ts.map

package/dist/posture/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/posture/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAyCpB,2BAA2B;AAC3B,wBAAgB,UAAU,IAAI,WAAW,CAExC;AAED,gDAAgD;AAChD,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,mDAAmD;AACnD,wBAAgB,UAAU,IAAI,cAAc,CAE3C;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,cAAc,GAAG,OAAO,CAEjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAgBjE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAMrD;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,IAAI,IAAI,CAInC;AAiCD,yDAAyD;AACzD,wBAAgB,aAAa,IAAI,IAAI,CAgBpC;AAoBD,mDAAmD;AACnD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBjD;AA8BD,iDAAiD;AACjD,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAED,wBAAgB,cAAc,IAAI,IAAI,CAKrC"}

package/dist/posture/engine.js

@@ -0,0 +1,217 @@
+/**
+ * Posture Engine — observes interaction patterns and adapts UI surface.
+ *
+ * The UI assembles itself around the user:
+ * - No interaction → silent mode, Core reaches out proactively
+ * - Light touches (pulse checks) → pulse mode
+ * - Deep dives (pages, agent logs, settings) → board mode
+ *
+ * Transitions happen automatically based on intent accumulation.
+ * The user can also pin a posture to lock it.
+ * Posture decays toward silent over time — if you stop looking, the UI fades.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { createLogger } from "../utils/logger.js";
+import { POSTURE_SURFACE } from "./types.js";
+const log = createLogger("posture");
+const BRAIN_DIR = resolve(process.cwd(), "brain");
+const STATE_PATH = join(BRAIN_DIR, "settings.json");
+// ── In-memory state ─────────────────────────────────────────────────────────
+const DEFAULT_STATE = {
+    current: "silent",
+    changedAt: new Date().toISOString(),
+    pinned: false,
+    interactions: {},
+    windowStart: new Date().toISOString(),
+};
+let state = { ...DEFAULT_STATE };
+// ── Thresholds ──────────────────────────────────────────────────────────────
+/** Interactions in a 24h window to trigger escalation */
+const ESCALATION_THRESHOLDS = {
+    /** Any interaction at all → at least pulse */
+    toPulse: 1,
+    /** Deep interactions (pages, agents, settings) → board */
+    toBoard: 5,
+};
+/** Hours of silence before decay */
+const DECAY_HOURS = {
+    /** Board → pulse after this many hours of no interaction */
+    boardToPulse: 48,
+    /** Pulse → silent after this many hours of no interaction */
+    pulseToSilent: 168, // 1 week
+};
+const WINDOW_MS = 24 * 60 * 60 * 1000; // 24h rolling window
+// ── Core API ────────────────────────────────────────────────────────────────
+/** Get current posture. */
+export function getPosture() {
+    return state.current;
+}
+/** Get current posture state (full details). */
+export function getPostureState() {
+    return { ...state };
+}
+/** Get the surface map for the current posture. */
+export function getSurface() {
+    return POSTURE_SURFACE[state.current];
+}
+/** Check if a specific surface is available. */
+export function hasSurface(surface) {
+    return POSTURE_SURFACE[state.current][surface];
+}
+/**
+ * Record an interaction signal. This is the primary input to the posture engine.
+ * Called by route handlers, middleware, or UI events.
+ */
+export function recordInteraction(signal) {
+    // Reset window if expired
+    const windowAge = Date.now() - new Date(state.windowStart).getTime();
+    if (windowAge > WINDOW_MS) {
+        state.interactions = {};
+        state.windowStart = new Date().toISOString();
+    }
+    // Increment counter for this surface
+    const key = signal.detail ? `${signal.surface}:${signal.detail}` : signal.surface;
+    state.interactions[key] = (state.interactions[key] || 0) + 1;
+    // Evaluate transition
+    if (!state.pinned) {
+        evaluateEscalation(signal);
+    }
+}
+/**
+ * Pin the current posture — locks auto-transitions until unpinned.
+ * User explicitly chose this level. Respect it.
+ */
+export function pinPosture(posture) {
+    state.current = posture;
+    state.pinned = true;
+    state.changedAt = new Date().toISOString();
+    log.info(`Posture pinned: ${posture}`);
+    saveState();
+}
+/** Unpin — allow auto-transitions again. */
+export function unpinPosture() {
+    state.pinned = false;
+    log.info("Posture unpinned — auto-transitions enabled");
+    saveState();
+}
+// ── Transition logic ────────────────────────────────────────────────────────
+function evaluateEscalation(signal) {
+    const prev = state.current;
+    const deepSurfaces = ["pages", "agents", "settings", "page-view"];
+    const isDeep = deepSurfaces.includes(signal.surface);
+    // Count deep interactions in current window
+    const deepCount = Object.entries(state.interactions)
+        .filter(([k]) => deepSurfaces.some(s => k.startsWith(s)))
+        .reduce((sum, [, v]) => sum + v, 0);
+    const totalCount = Object.values(state.interactions)
+        .reduce((sum, v) => sum + v, 0);
+    if (state.current === "silent") {
+        if (totalCount >= ESCALATION_THRESHOLDS.toPulse) {
+            transition("pulse");
+        }
+    }
+    else if (state.current === "pulse") {
+        if (isDeep && deepCount >= ESCALATION_THRESHOLDS.toBoard) {
+            transition("board");
+        }
+    }
+    // Board doesn't escalate further — it's the max
+    if (state.current !== prev) {
+        log.info(`Posture escalated: ${prev} → ${state.current} (${signal.surface})`);
+    }
+}
+/** Check for decay — called on a timer or at startup. */
+export function evaluateDecay() {
+    if (state.pinned)
+        return;
+    const hoursSinceChange = (Date.now() - new Date(state.changedAt).getTime()) / (60 * 60 * 1000);
+    const hoursSinceInteraction = getHoursSinceLastInteraction();
+    const prev = state.current;
+    if (state.current === "board" && hoursSinceInteraction >= DECAY_HOURS.boardToPulse) {
+        transition("pulse");
+    }
+    else if (state.current === "pulse" && hoursSinceInteraction >= DECAY_HOURS.pulseToSilent) {
+        transition("silent");
+    }
+    if (state.current !== prev) {
+        log.info(`Posture decayed: ${prev} → ${state.current} (${hoursSinceInteraction.toFixed(0)}h silent)`);
+    }
+}
+function getHoursSinceLastInteraction() {
+    // Use window start + max interaction timestamp
+    const windowAge = Date.now() - new Date(state.windowStart).getTime();
+    if (Object.keys(state.interactions).length === 0) {
+        return (Date.now() - new Date(state.changedAt).getTime()) / (60 * 60 * 1000);
+    }
+    // If there are interactions in the window, consider the window recent
+    return windowAge / (60 * 60 * 1000);
+}
+function transition(to) {
+    state.current = to;
+    state.changedAt = new Date().toISOString();
+    saveState();
+}
+// ── Persistence ─────────────────────────────────────────────────────────────
+/** Load posture state from brain/settings.json. */
+export async function loadPosture() {
+    try {
+        const raw = await readFile(STATE_PATH, "utf-8");
+        const settings = JSON.parse(raw);
+        if (settings.posture) {
+            state = {
+                current: settings.posture.current || "silent",
+                changedAt: settings.posture.changedAt || new Date().toISOString(),
+                pinned: settings.posture.pinned || false,
+                interactions: settings.posture.interactions || {},
+                windowStart: settings.posture.windowStart || new Date().toISOString(),
+            };
+            log.info(`Posture loaded: ${state.current}${state.pinned ? " (pinned)" : ""}`);
+        }
+    }
+    catch {
+        // No settings yet — start silent
+        state = { ...DEFAULT_STATE };
+    }
+    // Check for decay on load
+    evaluateDecay();
+}
+async function saveState() {
+    try {
+        let settings = {};
+        try {
+            const raw = await readFile(STATE_PATH, "utf-8");
+            settings = JSON.parse(raw);
+        }
+        catch { /* new file */ }
+        settings.posture = {
+            current: state.current,
+            changedAt: state.changedAt,
+            pinned: state.pinned,
+            interactions: state.interactions,
+            windowStart: state.windowStart,
+        };
+        await writeFile(STATE_PATH, JSON.stringify(settings, null, 2), "utf-8");
+    }
+    catch (err) {
+        log.warn("Failed to save posture state", {
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+// ── Decay timer ─────────────────────────────────────────────────────────────
+let decayTimer = null;
+/** Start the decay check timer — runs hourly. */
+export function startDecayTimer() {
+    if (decayTimer)
+        return;
+    decayTimer = setInterval(() => evaluateDecay(), 60 * 60 * 1000);
+    log.info("Posture decay timer started (1h interval)");
+}
+export function stopDecayTimer() {
+    if (decayTimer) {
+        clearInterval(decayTimer);
+        decayTimer = null;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/posture/engine.js.map

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

package/dist/posture/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Posture module — UI surface assembly around the user.
+ *
+ * Three modes: silent → pulse → board.
+ * Driven by intent accumulation, not configuration.
+ */
+export { getPosture, getPostureState, getSurface, hasSurface, recordInteraction, pinPosture, unpinPosture, evaluateDecay, loadPosture, startDecayTimer, stopDecayTimer, } from "./engine.js";
+export { postureTracker, pageViewTracker, requireSurface, postureHeader, } from "./middleware.js";
+export type { PostureName, PostureState, PostureSurface, InteractionSignal, } from "./types.js";
+export { POSTURE_SURFACE, POSTURE_LEVEL } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/posture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/posture/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/posture/index.js

@@ -0,0 +1,10 @@
+/**
+ * Posture module — UI surface assembly around the user.
+ *
+ * Three modes: silent → pulse → board.
+ * Driven by intent accumulation, not configuration.
+ */
+export { getPosture, getPostureState, getSurface, hasSurface, recordInteraction, pinPosture, unpinPosture, evaluateDecay, loadPosture, startDecayTimer, stopDecayTimer, } from "./engine.js";
+export { postureTracker, pageViewTracker, requireSurface, postureHeader, } from "./middleware.js";
+export { POSTURE_SURFACE, POSTURE_LEVEL } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/posture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/posture/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/posture/middleware.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Posture middleware — gates routes by current UI surface level
+ * and records interaction signals for intent accumulation.
+ *
+ * Routes return 404 (not 403) when posture is below threshold.
+ * The surface doesn't exist yet — it's not forbidden, it's not assembled.
+ */
+import type { MiddlewareHandler } from "hono";
+import type { PostureSurface } from "./types.js";
+/**
+ * Middleware: record every API interaction as a signal.
+ * Mounted early — runs for all /api/* routes.
+ */
+export declare function postureTracker(): MiddlewareHandler;
+/**
+ * Middleware: record page views (HTML page loads).
+ * Mounted on page routes like /board, /ops, /observatory, etc.
+ */
+export declare function pageViewTracker(pageName: string): MiddlewareHandler;
+/**
+ * Require a minimum posture level for a route group.
+ * Returns 404 if the surface isn't assembled yet.
+ */
+export declare function requireSurface(surface: keyof PostureSurface): MiddlewareHandler;
+/**
+ * Add posture info to API responses via header.
+ * Clients use this to know what to render.
+ */
+export declare function postureHeader(): MiddlewareHandler;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/posture/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/posture/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAsClD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CASnE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,cAAc,GAAG,iBAAiB,CAO/E;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAMjD"}

package/dist/posture/middleware.js

@@ -0,0 +1,92 @@
+/**
+ * Posture middleware — gates routes by current UI surface level
+ * and records interaction signals for intent accumulation.
+ *
+ * Routes return 404 (not 403) when posture is below threshold.
+ * The surface doesn't exist yet — it's not forbidden, it's not assembled.
+ */
+import { hasSurface, recordInteraction, getSurface } from "./engine.js";
+/**
+ * Middleware: record every API interaction as a signal.
+ * Mounted early — runs for all /api/* routes.
+ */
+export function postureTracker() {
+    return async (c, next) => {
+        const path = c.req.path;
+        // Classify the interaction
+        let surface = "chat";
+        let detail;
+        if (path.startsWith("/api/nerve") || path.startsWith("/api/pulse")) {
+            surface = "pulse";
+        }
+        else if (path.startsWith("/api/board")) {
+            surface = "pages";
+            detail = "board";
+        }
+        else if (path.startsWith("/api/ops")) {
+            surface = "pages";
+            detail = "ops";
+        }
+        else if (path.startsWith("/api/agents")) {
+            surface = "agents";
+        }
+        else if (path.startsWith("/api/settings") || path.startsWith("/api/admin")) {
+            surface = "settings";
+        }
+        else if (path.startsWith("/api/open-loops") || path.startsWith("/api/insights") || path.startsWith("/api/metrics")) {
+            surface = "pages";
+            detail = "observatory";
+        }
+        else if (path.startsWith("/api/chat")) {
+            surface = "chat";
+        }
+        else if (path.startsWith("/api/browse") || path.startsWith("/api/search")) {
+            surface = "pages";
+            detail = "browser";
+        }
+        recordInteraction({
+            timestamp: new Date().toISOString(),
+            surface,
+            detail,
+        });
+        await next();
+    };
+}
+/**
+ * Middleware: record page views (HTML page loads).
+ * Mounted on page routes like /board, /ops, /observatory, etc.
+ */
+export function pageViewTracker(pageName) {
+    return async (c, next) => {
+        recordInteraction({
+            timestamp: new Date().toISOString(),
+            surface: "page-view",
+            detail: pageName,
+        });
+        await next();
+    };
+}
+/**
+ * Require a minimum posture level for a route group.
+ * Returns 404 if the surface isn't assembled yet.
+ */
+export function requireSurface(surface) {
+    return async (c, next) => {
+        if (!hasSurface(surface)) {
+            return c.json({ error: "not_available", posture: "surface not assembled" }, 404);
+        }
+        await next();
+    };
+}
+/**
+ * Add posture info to API responses via header.
+ * Clients use this to know what to render.
+ */
+export function postureHeader() {
+    return async (c, next) => {
+        await next();
+        const surface = getSurface();
+        c.header("X-Posture-Surface", JSON.stringify(surface));
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/posture/middleware.js.map

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

package/dist/posture/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Posture — how much UI surface assembles around the user.
+ *
+ * Three modes:
+ * - silent:  No UI. Core works in background. Reaches out via chat/SMS/email.
+ * - pulse:   Three dots only. Tap for drill-down. Zero-to-one interaction.
+ * - board:   Full visibility. Threads, agents, memory, operations.
+ *
+ * Posture is orthogonal to tier (capabilities) and bonding (trust).
+ * A BYOK user might be silent. A Spawn user might only want pulse.
+ * UI is a symptom of unresolved autonomy — buttons exist because
+ * Core couldn't handle it alone yet.
+ *
+ * Posture is observed, not configured. Intent accumulation drives transitions.
+ * The system records interaction patterns and adapts surface area.
+ */
+export type PostureName = "silent" | "pulse" | "board";
+export declare const POSTURE_LEVEL: Record<PostureName, number>;
+/** What UI surfaces are available at each posture. */
+export interface PostureSurface {
+    /** Chat channel (always available — the minimum) */
+    chat: boolean;
+    /** Three-dot pulse strip */
+    pulse: boolean;
+    /** Drill-down panels when tapping dots */
+    drilldown: boolean;
+    /** Full page views: observatory, ops, board, library, etc. */
+    pages: boolean;
+    /** Agent task management UI */
+    agents: boolean;
+    /** Settings/configuration UI */
+    settings: boolean;
+}
+export declare const POSTURE_SURFACE: Record<PostureName, PostureSurface>;
+/**
+ * An interaction signal — recorded every time the user does something.
+ * Intent accumulation uses these to decide posture transitions.
+ */
+export interface InteractionSignal {
+    timestamp: string;
+    /** What surface the user touched */
+    surface: keyof PostureSurface | "page-view";
+    /** Specific detail — page name, dot tapped, etc. */
+    detail?: string;
+}
+/**
+ * Posture state — persisted in brain/settings.json alongside other settings.
+ */
+export interface PostureState {
+    /** Current posture */
+    current: PostureName;
+    /** When the posture last changed */
+    changedAt: string;
+    /** Whether the user explicitly set this (locks auto-transition) */
+    pinned: boolean;
+    /** Interaction count per surface in the current window */
+    interactions: Record<string, number>;
+    /** When the interaction window started */
+    windowStart: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/posture/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/posture/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAIrD,CAAC;AAEF,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,IAAI,EAAE,OAAO,CAAC;IACd,4BAA4B;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,cAAc,CAyB/D,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,MAAM,cAAc,GAAG,WAAW,CAAC;IAC5C,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,OAAO,EAAE,WAAW,CAAC;IACrB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,MAAM,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/posture/types.js

@@ -0,0 +1,48 @@
+/**
+ * Posture — how much UI surface assembles around the user.
+ *
+ * Three modes:
+ * - silent:  No UI. Core works in background. Reaches out via chat/SMS/email.
+ * - pulse:   Three dots only. Tap for drill-down. Zero-to-one interaction.
+ * - board:   Full visibility. Threads, agents, memory, operations.
+ *
+ * Posture is orthogonal to tier (capabilities) and bonding (trust).
+ * A BYOK user might be silent. A Spawn user might only want pulse.
+ * UI is a symptom of unresolved autonomy — buttons exist because
+ * Core couldn't handle it alone yet.
+ *
+ * Posture is observed, not configured. Intent accumulation drives transitions.
+ * The system records interaction patterns and adapts surface area.
+ */
+export const POSTURE_LEVEL = {
+    silent: 0,
+    pulse: 1,
+    board: 2,
+};
+export const POSTURE_SURFACE = {
+    silent: {
+        chat: true,
+        pulse: false,
+        drilldown: false,
+        pages: false,
+        agents: false,
+        settings: false,
+    },
+    pulse: {
+        chat: true,
+        pulse: true,
+        drilldown: true,
+        pages: false,
+        agents: false,
+        settings: false,
+    },
+    board: {
+        chat: true,
+        pulse: true,
+        drilldown: true,
+        pages: true,
+        agents: true,
+        settings: true,
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/posture/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/posture/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;CACT,CAAC;AAkBF,MAAM,CAAC,MAAM,eAAe,GAAwC;IAClE,MAAM,EAAE;QACN,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,KAAK;KAChB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,KAAK;KAChB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,IAAI;KACf;CACF,CAAC"}

package/dist/resend/inbox.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resend inbound email inbox — pull-on-activity pattern.
+ *
+ * Instead of a timer, Core checks for pending emails whenever it's
+ * already doing work. The check is debounced: at most once every 2 minutes.
+ * Emails are pulled from the Cloudflare Worker's KV-backed inbox,
+ * processed through the Brain pipeline, and acknowledged.
+ *
+ * Call `checkResendInbox()` from any activity hook — it's cheap when
+ * there's nothing to do (single GET, empty array).
+ */
+/**
+ * Check the Resend Worker inbox for pending emails.
+ * Debounced — returns immediately if checked recently.
+ * Safe to call frequently from any activity path.
+ */
+export declare function checkResendInbox(): Promise<void>;
+/**
+ * Force an immediate inbox check, bypassing the debounce.
+ * Useful for manual triggers (e.g., "check email" command).
+ */
+export declare function forceCheckResendInbox(): Promise<number>;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/resend/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../src/resend/inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+FH;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgDtD;AAmED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuB7D"}