@agentdeck/bridge 1.0.4 → 1.0.5

package/dist/calendar.js

@@ -0,0 +1,324 @@
+/**
+ * Glance schedule provider (ICS) — daemon-side module for the card-feed sleep
+ * dashboard (M9 stage 2). The device never parses a calendar itself; the
+ * daemon fetches the ICS feed(s), expands today's occurrences, and pre-renders
+ * them into `CardFeedResponse.glance.events` (shared/src/protocol.ts § Glance).
+ *
+ * Config comes from settings.json — one secret-address ICS URL (Google
+ * Calendar / iCloud / Fastmail all export one) or a list:
+ *
+ *   "calendar": { "ics": "https://calendar.google.com/calendar/ical/…/basic.ics" }
+ *   "calendar": { "ics": ["https://…/basic.ics", "https://…/work.ics"] }
+ *
+ * No config → no schedule in the glance (never a guess).
+ *
+ * Deliberately dependency-free, like weather.ts. The parser covers the ICS
+ * subset a personal "what's left of today" needs:
+ *   - VEVENT with SUMMARY / DTSTART / DTEND, line unfolding, text unescaping
+ *   - all-day events (VALUE=DATE), UTC instants (…Z), floating/TZID-local
+ *     times (TZID is assumed to be the daemon's own zone — the common case for
+ *     a personal calendar; a cross-zone TZID renders at its literal HH:MM)
+ *   - RRULE FREQ=DAILY/WEEKLY(BYDAY)/MONTHLY(BYMONTHDAY)/YEARLY with
+ *     INTERVAL / UNTIL / COUNT, expanded by bounded day-walk from DTSTART
+ *   - EXDATE and RECURRENCE-ID overrides (override replaces that instance)
+ */
+import { GLANCE_MAX_EVENTS, GLANCE_EVENT_TITLE_MAX_BYTES } from '@agentdeck/shared';
+import { trimUtf8Bytes } from './card-feed.js';
+/** Serve from cache inside this window — schedule cadence is slower than the
+ *  fastest pull cadence (900s). */
+export const CALENDAR_CACHE_MS = 30 * 60 * 1000;
+/** After a fetch failure, keep serving the last good parse up to this age. */
+export const CALENDAR_STALE_SERVE_MS = 6 * 60 * 60 * 1000;
+/** External peer await — timeout is first-line, not optional. */
+export const CALENDAR_FETCH_TIMEOUT_MS = 8000;
+/** Recurrence day-walk bound (~10 years) — a runaway RRULE must terminate. */
+const MAX_RECURRENCE_WALK_DAYS = 3700;
+export function parseCalendarSettings(settings) {
+    const c = settings?.calendar;
+    if (!c || typeof c !== 'object')
+        return null;
+    const raw = c.ics;
+    const urls = (Array.isArray(raw) ? raw : [raw])
+        .filter((u) => typeof u === 'string' && /^https?:\/\//.test(u));
+    return urls.length > 0 ? { urls } : null;
+}
+/** RFC 5545 line unfolding: CRLF followed by space/tab continues the line. */
+export function unfoldIcsLines(text) {
+    const raw = text.split(/\r?\n/);
+    const out = [];
+    for (const line of raw) {
+        if ((line.startsWith(' ') || line.startsWith('\t')) && out.length > 0) {
+            out[out.length - 1] += line.slice(1);
+        }
+        else if (line.length > 0) {
+            out.push(line);
+        }
+    }
+    return out;
+}
+function unescapeIcsText(s) {
+    return s.replace(/\\n/gi, ' ').replace(/\\([,;\\])/g, '$1');
+}
+const pad2 = (n) => String(n).padStart(2, '0');
+const dateKey = (d) => `${d.getFullYear()}${pad2(d.getMonth() + 1)}${pad2(d.getDate())}`;
+const hmKey = (d) => `${pad2(d.getHours())}:${pad2(d.getMinutes())}`;
+/** One DTSTART/DTEND/EXDATE value → local date + optional HH:MM.
+ *  `…Z` converts through the daemon clock; floating/TZID read literally. */
+export function parseIcsInstant(value) {
+    const m = value.match(/^(\d{8})(?:T(\d{2})(\d{2})(\d{2})?(Z)?)?$/);
+    if (!m)
+        return null;
+    const [, ymd, hh, mm, , zulu] = m;
+    if (!hh)
+        return { date: ymd };
+    if (zulu) {
+        const d = new Date(Date.UTC(Number(ymd.slice(0, 4)), Number(ymd.slice(4, 6)) - 1, Number(ymd.slice(6, 8)), Number(hh), Number(mm)));
+        return { date: dateKey(d), hm: hmKey(d) };
+    }
+    return { date: ymd, hm: `${hh}:${mm}` };
+}
+export function parseIcsEvents(text) {
+    const events = [];
+    let cur = null;
+    for (const line of unfoldIcsLines(text)) {
+        if (line === 'BEGIN:VEVENT') {
+            cur = { exdates: new Set() };
+            continue;
+        }
+        if (line === 'END:VEVENT') {
+            if (cur && cur.summary && cur.startDate) {
+                events.push({ ...cur, uid: cur.uid ?? '', summary: cur.summary, startDate: cur.startDate,
+                    exdates: cur.exdates });
+            }
+            cur = null;
+            continue;
+        }
+        if (!cur)
+            continue;
+        const colon = line.indexOf(':');
+        if (colon < 0)
+            continue;
+        const lhs = line.slice(0, colon);
+        const value = line.slice(colon + 1);
+        const name = lhs.split(';')[0].toUpperCase();
+        if (name === 'SUMMARY')
+            cur.summary = unescapeIcsText(value.trim());
+        else if (name === 'UID')
+            cur.uid = value.trim();
+        else if (name === 'DTSTART') {
+            const t = parseIcsInstant(value.trim());
+            if (t) {
+                cur.startDate = t.date;
+                if (t.hm !== undefined)
+                    cur.startHm = t.hm;
+            }
+        }
+        else if (name === 'DTEND') {
+            const t = parseIcsInstant(value.trim());
+            if (t) {
+                cur.endDate = t.date;
+                if (t.hm !== undefined)
+                    cur.endHm = t.hm;
+            }
+        }
+        else if (name === 'RRULE') {
+            cur.rrule = new Map(value.split(';').map((kv) => {
+                const eq = kv.indexOf('=');
+                return [kv.slice(0, eq).toUpperCase(), kv.slice(eq + 1)];
+            }));
+        }
+        else if (name === 'EXDATE') {
+            for (const v of value.split(',')) {
+                const t = parseIcsInstant(v.trim());
+                if (t)
+                    cur.exdates.add(t.date);
+            }
+        }
+        else if (name === 'RECURRENCE-ID') {
+            const t = parseIcsInstant(value.trim());
+            if (t)
+                cur.recurrenceId = t.date;
+        }
+    }
+    return events;
+}
+// ── Recurrence: does this event occur on `day`? ──
+const WEEKDAY_CODES = ['SU', 'MO', 'TU', 'WE', 'TH', 'FR', 'SA'];
+const dayFromKey = (key) => new Date(Number(key.slice(0, 4)), Number(key.slice(4, 6)) - 1, Number(key.slice(6, 8)));
+const daysBetween = (a, b) => Math.round((b.getTime() - a.getTime()) / 86_400_000);
+/** Occurrence check by bounded day-walk from DTSTART — one predicate per
+ *  FREQ, counting matches so COUNT/UNTIL terminate exactly. */
+export function occursOn(ev, dayKey) {
+    if (!ev.rrule)
+        return ev.startDate === dayKey;
+    if (ev.exdates.has(dayKey))
+        return false;
+    const freq = ev.rrule.get('FREQ') ?? '';
+    const interval = Math.max(1, Number(ev.rrule.get('INTERVAL') ?? '1') || 1);
+    const count = Number(ev.rrule.get('COUNT') ?? '0') || 0;
+    const untilRaw = ev.rrule.get('UNTIL');
+    const until = untilRaw ? parseIcsInstant(untilRaw)?.date : undefined;
+    if (until && dayKey > until)
+        return false;
+    if (dayKey < ev.startDate)
+        return false;
+    const start = dayFromKey(ev.startDate);
+    const target = dayFromKey(dayKey);
+    const span = daysBetween(start, target);
+    if (span < 0 || span > MAX_RECURRENCE_WALK_DAYS)
+        return false;
+    const byday = (ev.rrule.get('BYDAY') ?? '').split(',').filter(Boolean)
+        .map((d) => d.replace(/^[+-]?\d+/, '')); // ordinal BYDAY (1MO) → plain weekday
+    const bymonthday = Number(ev.rrule.get('BYMONTHDAY') ?? '0') || start.getDate();
+    const matches = (d, daysFromStart) => {
+        switch (freq) {
+            case 'DAILY':
+                return daysFromStart % interval === 0;
+            case 'WEEKLY': {
+                const wd = WEEKDAY_CODES[d.getDay()];
+                const inSet = byday.length > 0 ? byday.includes(wd) : d.getDay() === start.getDay();
+                // Interval counts weeks from DTSTART's week (weeks begin on Monday).
+                const mondayOffset = (dd) => (dd.getDay() + 6) % 7;
+                const weeks = Math.floor((daysFromStart + mondayOffset(start)) / 7);
+                return inSet && weeks % interval === 0;
+            }
+            case 'MONTHLY': {
+                const months = (d.getFullYear() - start.getFullYear()) * 12 + (d.getMonth() - start.getMonth());
+                return d.getDate() === bymonthday && months % interval === 0;
+            }
+            case 'YEARLY':
+                return d.getMonth() === start.getMonth() && d.getDate() === start.getDate()
+                    && (d.getFullYear() - start.getFullYear()) % interval === 0;
+            default:
+                return false;
+        }
+    };
+    if (!matches(target, span))
+        return false;
+    if (count > 0) {
+        // The target only counts if it is within the first COUNT occurrences.
+        let seen = 0;
+        for (let i = 0; i <= span; i++) {
+            const d = new Date(start.getFullYear(), start.getMonth(), start.getDate() + i);
+            if (matches(d, i)) {
+                seen++;
+                if (seen > count)
+                    return false;
+            }
+        }
+    }
+    return true;
+}
+// ── Today's glance events ──
+/** Expand all feeds' events into today's remaining schedule: all-day first,
+ *  then by start time; events already over are dropped; recurrence overrides
+ *  (RECURRENCE-ID) replace their master instance. */
+export function buildTodayEvents(events, now) {
+    const today = dateKey(now);
+    const nowHm = hmKey(now);
+    const overridden = new Set(events.filter((e) => e.recurrenceId).map((e) => `${e.uid}@${e.recurrenceId}`));
+    const picked = [];
+    for (const e of events) {
+        let onToday;
+        if (e.recurrenceId) {
+            onToday = e.startDate === today; // override instance: literal date only
+        }
+        else {
+            onToday = occursOn(e, today) && !(e.uid && overridden.has(`${e.uid}@${today}`));
+            // Multi-day timed event started earlier and still running → show as all-day.
+            if (!onToday && !e.rrule && e.startDate < today && (e.endDate ?? e.startDate) >= today) {
+                picked.push({ allDay: true, startHm: '', ev: { title: trimTitle(e.summary) } });
+                continue;
+            }
+        }
+        if (!onToday)
+            continue;
+        const allDay = e.startHm === undefined;
+        if (!allDay) {
+            const endHm = e.endHm && e.startDate === (e.endDate ?? e.startDate) ? e.endHm : undefined;
+            // Drop events that already ended (what's LEFT of today).
+            if ((endHm ?? e.startHm) < nowHm)
+                continue;
+            const ev = { startHm: e.startHm, title: trimTitle(e.summary) };
+            if (endHm)
+                ev.endHm = endHm;
+            picked.push({ allDay: false, startHm: e.startHm, ev });
+        }
+        else {
+            // DTEND of an all-day event is exclusive; a single-day event ends tomorrow.
+            picked.push({ allDay: true, startHm: '', ev: { title: trimTitle(e.summary) } });
+        }
+    }
+    picked.sort((a, b) => a.allDay !== b.allDay ? (a.allDay ? -1 : 1) : a.startHm.localeCompare(b.startHm));
+    // Dedup (same title + time can arrive from two feeds).
+    const seen = new Set();
+    const out = [];
+    for (const p of picked) {
+        const key = `${p.ev.startHm ?? ''}|${p.ev.title}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(p.ev);
+        if (out.length >= GLANCE_MAX_EVENTS)
+            break;
+    }
+    return out;
+}
+const trimTitle = (s) => trimUtf8Bytes(s, GLANCE_EVENT_TITLE_MAX_BYTES);
+export class CalendarProvider {
+    fetchImpl;
+    log;
+    cache = null;
+    inflight = null;
+    constructor(fetchImpl = fetch, log = () => { }) {
+        this.fetchImpl = fetchImpl;
+        this.log = log;
+    }
+    /** Today's remaining glance events for `cfg`, from cache when fresh.
+     *  Resolves `undefined` when unconfigured or when no parse (fresh or
+     *  stale-servable) exists — the glance simply omits the schedule. Today's
+     *  filter always runs against the CURRENT clock, so a cached parse still
+     *  drops events as they pass. Never throws. */
+    async get(cfg, now = Date.now()) {
+        if (!cfg)
+            return undefined;
+        const key = cfg.urls.join('\n');
+        const cached = this.cache;
+        if (cached && cached.key === key && now - cached.at < CALENDAR_CACHE_MS) {
+            return buildTodayEvents(cached.events, new Date(now));
+        }
+        if (this.inflight) {
+            const ev = await this.inflight;
+            return ev ? buildTodayEvents(ev, new Date(now)) : undefined;
+        }
+        this.inflight = this.fetchFresh(cfg, key, now).finally(() => { this.inflight = null; });
+        const ev = await this.inflight;
+        return ev ? buildTodayEvents(ev, new Date(now)) : undefined;
+    }
+    async fetchFresh(cfg, key, now) {
+        const ctl = new AbortController();
+        const timer = setTimeout(() => ctl.abort(), CALENDAR_FETCH_TIMEOUT_MS);
+        try {
+            const all = [];
+            for (const url of cfg.urls) {
+                const res = await this.fetchImpl(url, { signal: ctl.signal });
+                if (!res.ok)
+                    throw new Error(`ics HTTP ${res.status}`);
+                all.push(...parseIcsEvents(await res.text()));
+            }
+            this.cache = { key, at: now, events: all };
+            return all;
+        }
+        catch (err) {
+            this.log(`[calendar] fetch failed: ${err instanceof Error ? err.message : String(err)}`);
+            const cached = this.cache;
+            if (cached && cached.key === key && now - cached.at < CALENDAR_STALE_SERVE_MS)
+                return cached.events;
+            return undefined;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=calendar.js.map

package/dist/calendar.js.map

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

package/dist/card-feed.d.ts

@@ -4,11 +4,12 @@
  * HTTP routes live in daemon-server.ts. Contract: shared/src/protocol.ts
  * § Card Feed Pull Sync + docs/esp32-client-contract.md § Pull sync.
  *
- * M6 derives every card from a live session (the same rows `sessions_list`
- * broadcasts). M7 generalizes to daemon card modules (NUDGE / QUEST / …) that
- * will produce `day`-class cards; until then no producer emits `day`.
+ * M6 derives cards from live sessions (the same rows `sessions_list`
+ * broadcasts). M7 generalizes to daemon card modules; the Node daemon injects
+ * Autonomous Pocket's PULSE / NUDGE / QUEST producers into this pure builder.
  */
-import type { SessionInfo, FeedCard, CardFeedResponse, OutboxPushRequest, OutboxPushResponse } from '@agentdeck/shared';
+import type { SessionInfo, FeedCard, CardFeedResponse, CardFeedGlance, GlanceEvent, GlanceUsageRow, GlanceWeather, OutboxPushRequest, OutboxPushResponse } from '@agentdeck/shared';
+import type { UsageEvent } from './types.js';
 import { type CardModule } from './card-modules.js';
 /** A pulled permission gate is answerable only while the PreToolUse long-poll
  *  still holds the hook open (~60s) — pulled copies are honest about that. */
@@ -20,7 +21,40 @@ export declare const AWAITING_PROMPT_TTL_MS: number;
  *  interactive prompts are `live` (grey out offline, TTL-expire); everything
  *  else is a read-only `info` row. */
 export declare function classifySessionCard(s: SessionInfo, now: number): Pick<FeedCard, 'actionClass' | 'expiresAt'>;
-export declare function buildCardFeed(sessions: SessionInfo[], now?: number, modules?: CardModule[]): CardFeedResponse;
+/** UTF-8 byte-budget trim on a rune boundary — the device caps are bytes,
+ *  never code points (CJK is 3 bytes/char). */
+export declare function trimUtf8Bytes(s: string, maxBytes: number): string;
+/** Provider quota rows from the daemon's aggregate usage event. Claude first
+ *  (the primary subscription on this product), then Codex. A provider with no
+ *  numbers at all gets no row — the glance never renders an empty gauge. */
+export declare function buildGlanceUsage(usage: UsageEvent | undefined): GlanceUsageRow[];
+/** Work wrap-up lines — "what was being worked on", one line per session,
+ *  attention first. Pre-trimmed to the device byte budget; the renderer only
+ *  draws. */
+export declare function buildGlanceWrapup(sessions: SessionInfo[]): string[];
+export declare function buildGlance(input: {
+    sessions: SessionInfo[];
+    usage?: UsageEvent;
+    weather?: GlanceWeather;
+    events?: GlanceEvent[];
+}): CardFeedGlance | undefined;
+/** FNV-1a 32-bit over the canonical feed content: cards with volatile fields
+ *  stripped (see `VOLATILE_SESSION_FIELDS`) plus the glance verbatim. Matching
+ *  sigs mean the device's cached deck is still exactly what the daemon would
+ *  send. */
+export declare function computeDeckSig(cards: FeedCard[], glance?: CardFeedGlance): string;
+export interface BuildCardFeedOpts {
+    /** Sleep-dashboard summary to embed (and cover with the signature). */
+    glance?: CardFeedGlance;
+    /** `?sig=` echo from the device — when it matches the current signature the
+     *  response short-circuits to `unchanged: true` with empty cards. */
+    echoSig?: string;
+    /** Pocket-reader clients consume daemon-authored module cards, not live
+     *  session projections. Omitting those rows keeps the portable feed small
+     *  and makes AgentDeck one content source rather than the product shell. */
+    includeSessions?: boolean;
+}
+export declare function buildCardFeed(sessions: SessionInfo[], now?: number, modules?: CardModule[], opts?: BuildCardFeedOpts): CardFeedResponse;
 export interface OutboxApplyDeps {
     /** Current enriched roster — validity checks run against *live* state. */
     sessions: SessionInfo[];
@@ -56,6 +90,13 @@ export interface FeedPullEvent {
     driftPct?: number;
     /** Gap within `PULL_CADENCE_TOLERANCE` of the advertised cadence. */
     cadenceHonoured?: boolean;
+    /** Conditional pull answered `unchanged` — the deck signature matched. */
+    unchanged?: boolean;
+    /** Device telemetry from the `GET /feed` query string (`batt`/`mv`/`rssi`) —
+     *  the only battery/link observability a wake-sync-sleep device has. */
+    battPct?: number;
+    battMv?: number;
+    rssiDbm?: number;
 }
 export interface FeedPullClient {
     client: string;
@@ -70,9 +111,24 @@ export interface FeedPullClient {
     medianIntervalSec?: number;
     /** Intervals that landed inside the tolerance band, out of `pulls - 1`. */
     cadenceHonouredCount: number;
+    /** Latest reported telemetry (absent until the device sends it). */
+    lastBattPct?: number;
+    lastBattMv?: number;
+    lastRssiDbm?: number;
+    /** Pulls answered `unchanged` — how often the conditional pull saved work. */
+    unchangedCount: number;
 }
 /** `::ffff:192.168.68.77` and `::1` are the same peers as their v4 forms. */
 export declare function normalizeClientIp(ip: string): string;
+/** Telemetry that rides the `GET /feed` query string. */
+export interface PullTelemetry {
+    battPct?: number;
+    battMv?: number;
+    rssiDbm?: number;
+}
+/** Parse `batt`/`mv`/`rssi` query params, dropping anything non-numeric or
+ *  out of physical range — telemetry is advisory, never trusted blindly. */
+export declare function parsePullTelemetry(params: URLSearchParams): PullTelemetry;
 /** In-memory (daemon-lifetime) record of card-feed pulls, keyed by client IP.
  *  Deliberately not persisted: it answers "is the cadence working *now*". */
 export declare class FeedPullTracker {
@@ -92,6 +148,8 @@ export declare class FeedPullTracker {
         cards: number;
         nextPullSec: number;
         now?: number;
+        unchanged?: boolean;
+        telemetry?: PullTelemetry;
     }): FeedPullEvent;
     /** Most recent pulls, newest first. */
     recent(limit?: number): FeedPullEvent[];

package/dist/card-feed.d.ts.map

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