herdr-remote 0.2.18 → 0.2.20

package/src/agent-status.js

@@ -1,139 +0,0 @@
-'use strict';
-
-/**
- * What the agents on this workstation are doing, small enough to put in a
- * status bar.
- *
- * The question a phone actually has is "does anything need me?", and the
- * terminal is a poor way to ask it: finding a blocked agent means navigating
- * Herdr's sidebar through a viewport the width of a hand. Herdr already knows
- * the answer — it classifies every pane as idle, working, blocked, done or
- * unknown — so this turns a session snapshot into the two-line version.
- *
- * Deliberately a pure function over a snapshot. The socket, the debounce and
- * the retry live in the host connector; what counts as "needs me" lives here,
- * where it can be tested without either.
- */
-
-/** Herdr's own vocabulary, in the order a person cares about them. */
-const AGENT_STATUSES = ['blocked', 'done', 'working', 'idle', 'unknown'];
-
-/**
- * How many agents travel with the summary.
- *
- * The counts are always exact; this caps only the named list, which exists so a
- * future screen can say *which* agent is blocked. A workstation with more than
- * this many live agents is not going to be read off a phone anyway.
- */
-const MAX_LISTED_AGENTS = 16;
-
-/** Titles come from a remote program; keep them short and printable. */
-const MAX_TITLE_LENGTH = 48;
-
-function cleanText(value, limit = MAX_TITLE_LENGTH) {
-  if (typeof value !== 'string') return null;
-  // eslint-disable-next-line no-control-regex
-  const collapsed = value.replace(/[\u0000-\u001F\u007F-\u009F]/g, ' ').replace(/\s+/g, ' ').trim();
-  if (!collapsed) return null;
-  return collapsed.length > limit ? collapsed.slice(0, limit) : collapsed;
-}
-
-function normalizeStatus(value) {
-  return AGENT_STATUSES.includes(value) ? value : 'unknown';
-}
-
-function emptyCounts() {
-  return Object.fromEntries(AGENT_STATUSES.map((status) => [status, 0]));
-}
-
-/**
- * Turn `session.snapshot` into the summary the browser receives.
- *
- * Sorted by how much each status wants attention, so the capped list keeps the
- * agents worth naming rather than the first ones Herdr happened to report.
- * `focusedPaneId` and `focusedAgent` also track the live pane selection,
- * including shells and panes Herdr has not added to its agent summary.
- */
-function summarizeAgents(snapshot) {
-  const entries = Array.isArray(snapshot?.agents) ? snapshot.agents : [];
-  const panes = Array.isArray(snapshot?.panes) ? snapshot.panes : [];
-  const reportedFocusId = typeof snapshot?.focused_pane_id === 'string' && snapshot.focused_pane_id
-    ? snapshot.focused_pane_id
-    : null;
-  // `focused_pane_id` is the primary signal in Herdr snapshots. The focused
-  // flags are a fallback for snapshots where that top-level field is absent.
-  const focusedPane = (reportedFocusId
-    ? panes.find((pane) => pane?.pane_id === reportedFocusId)
-    : panes.find((pane) => pane?.focused === true)) || null;
-  const focusedAgentEntry = (reportedFocusId
-    ? entries.find((entry) => entry?.pane_id === reportedFocusId)
-    : entries.find((entry) => entry?.focused === true)) || null;
-  const focusedPaneId = reportedFocusId
-    || (typeof focusedPane?.pane_id === 'string' ? focusedPane.pane_id : null)
-    || (typeof focusedAgentEntry?.pane_id === 'string' ? focusedAgentEntry.pane_id : null);
-  const focusedAgent = typeof focusedPane?.agent === 'string'
-    ? focusedPane.agent
-    : typeof focusedAgentEntry?.agent === 'string'
-      ? focusedAgentEntry.agent
-      : null;
-  const counts = emptyCounts();
-  const ranked = [];
-
-  for (const entry of entries) {
-    if (!entry || typeof entry.pane_id !== 'string') continue;
-    const status = normalizeStatus(entry.agent_status);
-    counts[status] += 1;
-    ranked.push({
-      paneId: entry.pane_id,
-      workspaceId: typeof entry.workspace_id === 'string' ? entry.workspace_id : null,
-      agent: cleanText(entry.display_agent || entry.agent, 24),
-      title: cleanText(entry.terminal_title_stripped || entry.terminal_title),
-      status,
-      focused: entry.focused === true,
-    });
-  }
-
-  ranked.sort((left, right) => AGENT_STATUSES.indexOf(left.status) - AGENT_STATUSES.indexOf(right.status));
-
-  return {
-    focusedPaneId,
-    focusedAgent,
-    counts,
-    // Total rather than a sum the browser has to compute, and the one number a
-    // collapsed chip can show on its own.
-    total: ranked.length,
-    agents: ranked.slice(0, MAX_LISTED_AGENTS),
-  };
-}
-
-/** Whether two summaries say the same thing, so an unchanged one is not sent. */
-function sameSummary(left, right) {
-  if (!left || !right) return left === right;
-  if (left.focusedPaneId !== right.focusedPaneId || left.focusedAgent !== right.focusedAgent) return false;
-  if (left.total !== right.total) return false;
-  for (const status of AGENT_STATUSES) {
-    if ((left.counts?.[status] || 0) !== (right.counts?.[status] || 0)) return false;
-  }
-  if (left.agents.length !== right.agents.length) return false;
-  return left.agents.every((agent, index) => {
-    const other = right.agents[index];
-    return other
-      && agent.paneId === other.paneId
-      && agent.status === other.status
-      && agent.agent === other.agent
-      && agent.title === other.title;
-  });
-}
-
-/** The summary of a workstation with nothing to report, or nothing to ask. */
-function emptySummary() {
-  return { focusedPaneId: null, focusedAgent: null, counts: emptyCounts(), total: 0, agents: [] };
-}
-
-module.exports = {
-  AGENT_STATUSES,
-  MAX_LISTED_AGENTS,
-  emptySummary,
-  sameSummary,
-  summarizeAgents,
-};

package/src/binary-plist.js

@@ -1,146 +0,0 @@
-'use strict';
-
-/**
- * Reads Apple binary property lists (`bplist00`), the format macOS writes its
- * preference files in, and the NSKeyedArchiver graphs stored inside them.
- *
- * Terminal.app keeps each profile's font as an archived NSFont — a binary
- * plist nested in a binary plist — and there is no command-line tool that
- * turns that into something readable without asking Terminal itself (an
- * AppleScript that prompts for Automation access). A reader this small is
- * less intrusive than any of those.
- */
-
-/** A reference to another object in a keyed archive (`CF$UID`). */
-class Uid {
-  constructor(value) {
-    this.value = value;
-  }
-}
-
-function readSizedInt(buffer, offset, size) {
-  let value = 0;
-  for (let i = 0; i < size; i += 1) value = value * 256 + buffer[offset + i];
-  return value;
-}
-
-/**
- * Parses a whole `bplist00` buffer into plain values: objects, arrays,
- * strings, numbers, booleans, Buffers (data), Dates and `Uid`s. Throws on
- * anything malformed; callers treat that as "no answer".
- */
-function parseBinaryPlist(buffer) {
-  if (!Buffer.isBuffer(buffer) || buffer.length < 40 || buffer.toString('latin1', 0, 8) !== 'bplist00') {
-    throw new Error('not a binary plist');
-  }
-  const trailer = buffer.length - 32;
-  const offsetSize = buffer[trailer + 6];
-  const refSize = buffer[trailer + 7];
-  const count = readSizedInt(buffer, trailer + 8, 8);
-  const top = readSizedInt(buffer, trailer + 16, 8);
-  const tableOffset = readSizedInt(buffer, trailer + 24, 8);
-  if (!offsetSize || !refSize || count > 1_000_000 || tableOffset + count * offsetSize > trailer) {
-    throw new Error('corrupt binary plist trailer');
-  }
-  const offsets = [];
-  for (let i = 0; i < count; i += 1) offsets.push(readSizedInt(buffer, tableOffset + i * offsetSize, offsetSize));
-
-  const parsing = new Set();
-  const parse = (index) => {
-    if (index >= count || parsing.has(index)) throw new Error('corrupt binary plist reference');
-    parsing.add(index);
-    try {
-      return parseObject(offsets[index]);
-    } finally {
-      parsing.delete(index);
-    }
-  };
-
-  // A length stored in the marker's low nibble, or as the int object after it.
-  const lengthAt = (offset) => {
-    const low = buffer[offset] & 0x0f;
-    if (low !== 0x0f) return { length: low, start: offset + 1 };
-    const marker = buffer[offset + 1];
-    if ((marker & 0xf0) !== 0x10) throw new Error('corrupt binary plist length');
-    const size = 1 << (marker & 0x0f);
-    return { length: readSizedInt(buffer, offset + 2, size), start: offset + 2 + size };
-  };
-
-  const parseObject = (offset) => {
-    const marker = buffer[offset];
-    const type = marker >> 4;
-    const low = marker & 0x0f;
-    switch (type) {
-      case 0x0:
-        if (marker === 0x08) return false;
-        if (marker === 0x09) return true;
-        return null;
-      case 0x1: {
-        const size = 1 << low;
-        if (size === 8) return Number(buffer.readBigInt64BE(offset + 1));
-        return readSizedInt(buffer, offset + 1, size);
-      }
-      case 0x2:
-        return low === 2 ? buffer.readFloatBE(offset + 1) : buffer.readDoubleBE(offset + 1);
-      case 0x3:
-        return new Date(Date.UTC(2001, 0, 1) + buffer.readDoubleBE(offset + 1) * 1000);
-      case 0x4: {
-        const { length, start } = lengthAt(offset);
-        return buffer.subarray(start, start + length);
-      }
-      case 0x5: {
-        const { length, start } = lengthAt(offset);
-        return buffer.toString('latin1', start, start + length);
-      }
-      case 0x6: {
-        const { length, start } = lengthAt(offset);
-        return Buffer.from(buffer.subarray(start, start + length * 2)).swap16().toString('utf16le');
-      }
-      case 0x8:
-        return new Uid(readSizedInt(buffer, offset + 1, low + 1));
-      case 0xa:
-      case 0xc: {
-        const { length, start } = lengthAt(offset);
-        const items = [];
-        for (let i = 0; i < length; i += 1) items.push(parse(readSizedInt(buffer, start + i * refSize, refSize)));
-        return items;
-      }
-      case 0xd: {
-        const { length, start } = lengthAt(offset);
-        const result = {};
-        for (let i = 0; i < length; i += 1) {
-          const key = parse(readSizedInt(buffer, start + i * refSize, refSize));
-          result[String(key)] = parse(readSizedInt(buffer, start + (length + i) * refSize, refSize));
-        }
-        return result;
-      }
-      default:
-        throw new Error(`unsupported binary plist object 0x${marker.toString(16)}`);
-    }
-  };
-
-  return parse(top);
-}
-
-/**
- * The root object of an NSKeyedArchiver plist, with every `Uid` replaced by
- * the object it points at (to a bounded depth; archives may be cyclic).
- */
-function unarchiveKeyed(archive, depth = 6) {
-  const objects = archive?.$objects;
-  const rootRef = archive?.$top?.root;
-  if (!Array.isArray(objects) || !(rootRef instanceof Uid)) throw new Error('not a keyed archive');
-  const resolve = (value, level) => {
-    if (value instanceof Uid) return level > depth ? null : resolve(objects[value.value], level + 1);
-    if (Array.isArray(value)) return value.map((item) => resolve(item, level));
-    if (value && typeof value === 'object' && !Buffer.isBuffer(value) && !(value instanceof Date)) {
-      const result = {};
-      for (const [key, item] of Object.entries(value)) result[key] = resolve(item, level);
-      return result;
-    }
-    return value === '$null' ? null : value;
-  };
-  return resolve(rootRef, 0);
-}
-
-module.exports = { Uid, parseBinaryPlist, unarchiveKeyed };