@fdcn/sourcefed 0.3.7 → 0.3.8

package/dist/data/core/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: core
-description: Core sourcefed usage guide. Read this before creating monitors. Covers monitor creation per source (Jira issue, GitHub PR, Slack thread), event delivery and acknowledgement semantics, daemon modes, CLI usage, and troubleshooting. Use when the user asks to watch or monitor a Jira ticket, GitHub PR, Slack thread, or when sourcefed monitor events arrive in the session.
+description: Core sourcefed usage guide. Read this before creating monitors. Covers monitor creation per source (Jira issue, GitHub PR, Slack thread, Yab feed), event delivery and acknowledgement semantics, daemon modes, CLI usage, and troubleshooting. Use when the user asks to watch or monitor a Jira ticket, GitHub PR, Slack thread, a feed or inbox they are signed in to in Yab, or when sourcefed monitor events arrive in the session.
 ---
 
 # Sourcefed core
 
-Sourcefed lets you create **monitors** that watch a Jira issue, GitHub PR, or
-Slack thread or direct-message conversation and route NEW events into the session you're currently working in,
+Sourcefed lets you create **monitors** that watch a Jira issue, GitHub PR,
+Slack thread or direct-message conversation, or a feed read through Yab, and route NEW events into the session you're currently working in,
 so you can react to them as they happen.
 
 Every monitor is detect-only: it routes events into the session and never
@@ -21,6 +21,7 @@ affect that session's monitors.
 - **GitHub PR**: `monitor_create({ name: "PR #42", sourceType: "github", repo: "owner/repo", prNumber: 42 })`
 - **Slack thread**: `monitor_create({ name: "thread", sourceType: "slack", threadUrl: "<thread-url>" })`
 - **Whole Slack DM**: `monitor_create({ name: "DM with Alex", sourceType: "slack", channelId: "D0123456789" })`
+- **Yab feed**: `monitor_create({ name: "inbox", sourceType: "yab", url: "https://mail.google.com/mail/u/0/feed/atom", space: "Personal", match: "interview|offer", exclude: "newsletter" })`
 
 You will be notified of:
 
@@ -30,9 +31,13 @@ You will be notified of:
 - **Slack thread**: new replies in the thread.
 - **Slack DM**: new top-level messages in the DM. Slack monitors are always detect-only
   and never reply.
+- **Yab feed**: each new entry of an Atom, RSS or JSON feed, read through the user's Yab
+  browser with their sign-ins (so private feeds like Gmail's unread-inbox feed work).
+  `space` picks the Yab space; `match`/`exclude` are case-insensitive regexes over the
+  entry's title, summary and author. Yab must be running.
 
 GitHub and Slack use webhook delivery when configured and fall back to polling
-when unavailable. Jira always uses polling. You can lower `pollIntervalSec`
+when unavailable. Jira and Yab always use polling. You can lower `pollIntervalSec`
 (min 15) for time-sensitive work, but prefer the default to avoid hammering
 APIs.
 

package/dist/data/core/references/commands.md

@@ -26,13 +26,17 @@ sourcefed skills path [name]                Print skill directory path
 
 ```text
 --name NAME           Human-readable monitor name (defaults to the source type)
---source-type TYPE    jira | github | slack
+--source-type TYPE    jira | github | slack | yab
 --issue-key KEY       Jira issue key (jira)
 --repo OWNER/NAME     GitHub repository (github)
 --pr-number N         GitHub PR number (github)
 --channel-id ID       Slack channel or DM ID; a D… ID alone monitors the whole DM
 --thread-ts TS        Slack parent message timestamp; omit for a whole-DM monitor
 --thread-url URL      Slack thread URL (slack)
+--url URL             Atom, RSS or JSON feed URL read through Yab (yab)
+--space NAME          Yab space whose sign-ins to use (yab)
+--match REGEX         Only deliver entries matching this case-insensitive regex (yab)
+--exclude REGEX       Skip entries matching this case-insensitive regex (yab)
 --poll-interval-sec N Poll interval in seconds (min 15)
 --target-kind KIND    Target kind for ownership scoping (default: cli)
 --target-id ID        Target id for ownership scoping (default: hostname)
@@ -54,6 +58,7 @@ SOURCEFED_JIRA_TERMINAL_STATUS  Jira status that auto-removes monitors
 GH_TOKEN / GITHUB_TOKEN         GitHub token for direct API polling
 SOURCEFED_GITHUB_WEBHOOK_SECRET GitHub webhook secret (enables webhooks)
 SOURCEFED_SLACK_SIGNING_SECRET  Slack signing secret (enables webhooks)
+SOURCEFED_YAB_COMMAND           Yab binary for yab monitors (default /Applications/yab.app/Contents/MacOS/yab)
 SOURCEFED_SKILLS_DIR            Override the bundled skills directory
 ```
 

package/dist/data/sourcefed/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: sourcefed
-description: Live Jira, GitHub, and Slack monitoring for agent hosts. Create monitors that route new issue comments, PR reviews, CI failures, and Slack thread or DM messages into the current session as they happen.
+description: Live Jira, GitHub, Slack, and Yab feed monitoring for agent hosts. Create monitors that route new issue comments, PR reviews, CI failures, Slack thread or DM messages, and new entries of feeds read through Yab into the current session as they happen.
 hidden: true
 ---
 
 # Sourcefed
 
 Sourcefed turns external collaboration threads into live agent input: create a
-monitor for a Jira issue, GitHub PR, Slack thread, or Slack DM and NEW events are routed
+monitor for a Jira issue, GitHub PR, Slack thread, Slack DM, or a feed read through Yab and NEW events are routed
 into the session you are working in, so you can react to them as they happen.
 
 This file is a discovery stub, not the usage guide. Before running any
@@ -25,6 +25,7 @@ releases, which is why it just points at `skills get core`.
 ## When to load this skill
 
 - A user asks to monitor a Jira ticket, GitHub PR, Slack thread, or Slack DM.
+- A user wants to hear about new entries in a feed or inbox they are signed in to in Yab.
 - You found or are working on a Jira ticket, PR, thread, or DM and want new
   activity routed into your session.
 - You opened a PR and want to be notified of reviews, comments, CI failures,

package/dist/guidance.md

@@ -1,6 +1,7 @@
 # sourcefed monitors
 
-Monitors watch a Jira issue, GitHub PR, or Slack thread and bring new events into this session.
+Monitors watch a Jira issue, GitHub PR, Slack thread, or a feed read through Yab and bring new events
+into this session.
 
 Create one with `monitor_create` when:
 
@@ -9,7 +10,10 @@ Create one with `monitor_create` when:
 - your branch has a PR: `{ name: "<pr>", sourceType: "github", repo: "owner/name", prNumber: 42 }`
   (reviews, comments, CI failures, conflicts, merge or close);
 - you were given a Slack thread: `{ name: "<thread>", sourceType: "slack", threadUrl: "<url>" }`
-  (new messages; read-only, never replies).
+  (new messages; read-only, never replies);
+- the user wants new entries of a feed they are signed in to in Yab (unread Gmail, a job board's RSS):
+  `{ name: "<feed>", sourceType: "yab", url: "https://mail.google.com/mail/u/0/feed/atom", space: "Personal", match: "interview|offer" }`
+  (each new entry; `match`/`exclude` are case-insensitive regexes; Yab must be running).
 
 Keep the default `pollIntervalSec` unless the work is time-sensitive (min 15).
 `monitor_list`, `monitor_status { id }` and `monitor_stop { id }` act on this session's monitors.

package/dist/mcp.js

@@ -1,7 +1,7 @@
 import {
   decodeTarget,
   encodeTarget
-} from "./chunk-E6J3BAXP.js";
+} from "./chunk-5JL3UV72.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";
@@ -4680,6 +4680,10 @@ function buildServer(daemon) {
     channelId: string2().optional(),
     threadTs: string2().optional(),
     threadUrl: string2().optional(),
+    url: string2().optional(),
+    space: string2().optional(),
+    match: string2().optional(),
+    exclude: string2().optional(),
     pollIntervalSec: number2().min(15).optional(),
     target: targetSchema
   });
@@ -4693,7 +4697,7 @@ function buildServer(daemon) {
   server.registerTool(
     "monitor_create",
     {
-      description: "Create or reuse a monitor for a Jira issue, GitHub pull request, Slack thread, or Slack DM.",
+      description: "Create or reuse a monitor for a Jira issue, GitHub pull request, Slack thread, Slack DM, or a feed read through Yab.",
       inputSchema: createSchema,
       annotations: { idempotentHint: true, readOnlyHint: false }
     },

package/dist/opencode.js

@@ -7,7 +7,7 @@ import {
   daemonCommand,
   daemonEnvironment,
   spawnLocalDaemon
-} from "./chunk-E6J3BAXP.js";
+} from "./chunk-5JL3UV72.js";
 import "./chunk-MLKGABMK.js";
 
 // packages/sourcefed/src/server.ts
@@ -357,7 +357,7 @@ async function callMonitorTool(bridge, name, arguments_, sessionID) {
 // adapters/opencode/tools/monitor_create.ts
 var monitor_create_default = (bridge) => ({
   name: "monitor_create",
-  description: "Create a detect-only monitor that watches a Jira issue, GitHub PR, Slack thread, or Slack DM and routes NEW events into the current session. Slack monitors only read and notify; they never reply. GitHub and Slack use webhooks when configured and polling otherwise; Jira uses polling.",
+  description: "Create a detect-only monitor that watches a Jira issue, GitHub PR, Slack thread, Slack DM, or a feed read through Yab (the user's browser, with their sign-ins) and routes NEW events into the current session. Slack monitors only read and notify; they never reply. GitHub and Slack use webhooks when configured and polling otherwise; Jira and Yab use polling.",
   input: {
     type: "object",
     properties: {
@@ -369,6 +369,10 @@ var monitor_create_default = (bridge) => ({
       channelId: { type: "string", description: "Slack channel or DM ID. A DM ID without threadTs monitors the whole DM conversation." },
       threadTs: { type: "string", description: "Slack parent message timestamp. Omit it with a DM ID to monitor the whole DM conversation." },
       threadUrl: { type: "string", description: "Slack thread URL (alternative to channelId + threadTs)" },
+      url: { type: "string", description: "Atom, RSS or JSON feed URL read through Yab with the user's sign-ins, e.g. https://mail.google.com/mail/u/0/feed/atom (required if sourceType=yab)" },
+      space: { type: "string", description: "Yab space whose sign-ins to use (yab); omit to use wherever the site is signed in" },
+      match: { type: "string", description: "Case-insensitive regex; only entries whose title, summary or author match are delivered (yab)" },
+      exclude: { type: "string", description: "Case-insensitive regex; entries that match are skipped (yab)" },
       pollIntervalSec: { type: "number", description: "Optional polling interval in seconds (min 15, default 60)" }
     },
     required: ["name", "sourceType"],

package/dist/pi.js

@@ -6,7 +6,7 @@ import {
   daemonCommand,
   daemonEnvironment,
   spawnLocalDaemon
-} from "./chunk-E6J3BAXP.js";
+} from "./chunk-5JL3UV72.js";
 import "./chunk-MLKGABMK.js";
 
 // adapters/pi/src/index.ts
@@ -39,35 +39,6 @@ function showSourcefedDialog(_tui, theme, done, title, lines) {
     }
   };
 }
-function monitorLines(monitors, theme) {
-  const active = monitors.filter((monitor) => monitor.enabled);
-  if (active.length === 0) return [{ text: theme.fg("dim", "No active monitors") }];
-  return active.flatMap((monitor) => {
-    const status = monitor.unresponsive ? theme.fg("error", "\u25CF") : theme.fg("success", "\u25CF");
-    const describe = theme.fg("text", monitor.describe);
-    const detail = monitor.detail ? theme.fg("muted", monitor.detail) : "";
-    const statusLabel = monitor.unresponsive ? "recovering connection" : "healthy";
-    const rows = [
-      ["Name", monitor.name],
-      ["Delivery", monitor.delivery],
-      ["Poll interval", `${monitor.pollIntervalSec}s`],
-      ["Created", formatTime(monitor.createdAt)],
-      ["Updated", formatTime(monitor.updatedAt)],
-      ["Last poll", formatTime(monitor.lastPolledAt)],
-      ["Webhook heartbeat", formatTime(monitor.webhookHeartbeatAt)]
-    ];
-    return [
-      { text: `${status} ${monitor.icon} ${describe}${detail} [${statusLabel}]` },
-      ...rows.map(([label, value]) => ({ text: theme.fg("muted", `   ${label}: ${value}`) }))
-    ];
-  });
-}
-function formatTime(value) {
-  if (!value) return "never";
-  const date = new Date(value);
-  if (Number.isNaN(date.getTime())) return value;
-  return date.toLocaleString();
-}
 function logLines(logs, theme) {
   if (logs.length === 0) return [{ text: theme.fg("dim", "No notifications sent yet") }];
   return logs.flatMap((entry) => {
@@ -80,12 +51,145 @@ function logLines(logs, theme) {
   });
 }
 
+// adapters/pi/src/monitors-dialog.ts
+import { truncateToWidth as truncateToWidth2 } from "@earendil-works/pi-tui";
+var PROGRESS = { stop: "Stopping", start: "Starting", remove: "Deleting" };
+var MonitorManager = class {
+  constructor(monitors, deps) {
+    this.deps = deps;
+    this.monitors = monitors;
+  }
+  monitors;
+  selected = 0;
+  mode = { kind: "browse" };
+  error;
+  handleInput(data) {
+    switch (this.mode.kind) {
+      case "busy":
+        return;
+      case "confirm-remove":
+        return this.handleConfirm(data, this.mode.monitor);
+      case "browse":
+        return this.handleBrowse(data);
+    }
+  }
+  render(width) {
+    const { theme } = this.deps;
+    const active = this.monitors.filter((monitor) => monitor.enabled).length;
+    const border = theme.fg("accent", "\u2500".repeat(Math.max(0, width)));
+    const lines = [
+      border,
+      ` ${theme.fg("accent", theme.bold(`Sourcefed monitors (${active} active)`))}`,
+      "",
+      ...this.listLines(),
+      "",
+      ...this.statusLines(),
+      border
+    ];
+    return lines.map((line) => truncateToWidth2(line, width));
+  }
+  invalidate() {
+  }
+  handleBrowse(data) {
+    if (this.matches(data, "tui.select.cancel") || this.matches(data, "tui.select.confirm")) return this.deps.close();
+    if (this.matches(data, "tui.select.up")) return this.select(this.selected - 1);
+    if (this.matches(data, "tui.select.down")) return this.select(this.selected + 1);
+    const monitor = this.monitors[this.selected];
+    if (!monitor) return;
+    if (data === "s") void this.perform(monitor.enabled ? "stop" : "start", monitor);
+    if (data === "d") this.setMode({ kind: "confirm-remove", monitor });
+  }
+  handleConfirm(data, monitor) {
+    if (data === "y") void this.perform("remove", monitor);
+    else if (data === "n" || this.matches(data, "tui.select.cancel")) this.setMode({ kind: "browse" });
+  }
+  async perform(action, monitor) {
+    this.error = void 0;
+    this.setMode({ kind: "busy", label: `${PROGRESS[action]} ${monitor.name}\u2026` });
+    try {
+      this.monitors = await this.deps.run(action, monitor.id);
+      const kept = this.monitors.findIndex((candidate) => candidate.id === monitor.id);
+      this.selected = clamp(kept >= 0 ? kept : this.selected, this.monitors.length);
+    } catch (error) {
+      this.error = error instanceof Error ? error.message : String(error);
+    }
+    this.setMode({ kind: "browse" });
+  }
+  select(index) {
+    this.selected = clamp(index, this.monitors.length);
+    this.deps.requestRender();
+  }
+  setMode(mode) {
+    this.mode = mode;
+    this.deps.requestRender();
+  }
+  matches(data, keybinding) {
+    return this.deps.keys.matches(data, keybinding);
+  }
+  listLines() {
+    const { theme } = this.deps;
+    if (this.monitors.length === 0) return [` ${theme.fg("dim", "No monitors")}`];
+    return this.monitors.flatMap((monitor, index) => {
+      const selected = index === this.selected;
+      const marker = selected ? theme.fg("accent", "\u203A") : " ";
+      const header = ` ${marker} ${statusDot(monitor, theme)} ${monitor.icon} ${theme.fg("text", monitor.describe)} [${statusLabel(monitor)}]`;
+      return selected ? [header, ...detailLines(monitor, theme)] : [header];
+    });
+  }
+  statusLines() {
+    const { theme } = this.deps;
+    const lines = [];
+    if (this.error) lines.push(` ${theme.fg("error", this.error)}`);
+    switch (this.mode.kind) {
+      case "busy":
+        lines.push(` ${theme.fg("muted", this.mode.label)}`);
+        break;
+      case "confirm-remove":
+        lines.push(` ${theme.fg("warning", `Delete ${this.mode.monitor.name}? It stops watching and its record is removed. y/n`)}`);
+        break;
+      case "browse":
+        lines.push(` ${theme.fg("dim", "\u2191\u2193 select \xB7 s stop/start \xB7 d delete \xB7 esc close")}`);
+    }
+    return lines;
+  }
+};
+function clamp(index, length) {
+  return Math.min(Math.max(index, 0), Math.max(length - 1, 0));
+}
+function statusLabel(monitor) {
+  if (!monitor.enabled) return "stopped";
+  return monitor.unresponsive ? "recovering connection" : "healthy";
+}
+function statusDot(monitor, theme) {
+  if (!monitor.enabled) return theme.fg("dim", "\u25CF");
+  return theme.fg(monitor.unresponsive ? "error" : "success", "\u25CF");
+}
+function detailLines(monitor, theme) {
+  const rows = [
+    ["Name", monitor.name],
+    ["Delivery", monitor.delivery],
+    ["Poll interval", `${monitor.pollIntervalSec}s`],
+    ["Created", formatTime(monitor.createdAt)],
+    ["Updated", formatTime(monitor.updatedAt)],
+    ["Last poll", formatTime(monitor.lastPolledAt)],
+    ["Webhook heartbeat", formatTime(monitor.webhookHeartbeatAt)]
+  ];
+  return rows.map(([label, value]) => theme.fg("muted", `     ${label}: ${value}`));
+}
+function formatTime(value) {
+  if (!value) return "never";
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return value;
+  return date.toLocaleString();
+}
+
 // adapters/pi/src/index.ts
 var STATUS_REFRESH_MS = 3e3;
 var SOURCE_ICONS = {
   jira: "\u{F0303}",
   github: "\u{F02A4}",
-  slack: "\u{F04B1}"
+  slack: "\u{F04B1}",
+  yab: "\u{F059F}"
 };
 async function sourcefedExtension(pi) {
   const listeners = /* @__PURE__ */ new Map();
@@ -113,16 +217,20 @@ async function sourcefedExtension(pi) {
   pi.registerTool({
     name: "sourcefed_monitor_create",
     label: "Sourcefed monitor create",
-    description: "Create or reuse a Jira, GitHub PR, Slack thread, or Slack DM monitor for the current Pi session.",
+    description: "Create or reuse a Jira, GitHub PR, Slack thread, Slack DM, or Yab feed monitor for the current Pi session.",
     parameters: Type.Object({
       name: Type.String(),
-      sourceType: Type.Unsafe({ type: "string", enum: ["jira", "github", "slack"] }),
+      sourceType: Type.Unsafe({ type: "string", enum: ["jira", "github", "slack", "yab"] }),
       issueKey: Type.Optional(Type.String()),
       repo: Type.Optional(Type.String()),
       prNumber: Type.Optional(Type.Number()),
       channelId: Type.Optional(Type.String()),
       threadTs: Type.Optional(Type.String()),
       threadUrl: Type.Optional(Type.String()),
+      url: Type.Optional(Type.String()),
+      space: Type.Optional(Type.String()),
+      match: Type.Optional(Type.String()),
+      exclude: Type.Optional(Type.String()),
       pollIntervalSec: Type.Optional(Type.Number())
     }),
     execute: async (_toolCallID, input, _signal, _onUpdate, ctx) => toolResult(await call(ctx, "monitor_create", input))
@@ -156,12 +264,23 @@ async function sourcefedExtension(pi) {
     execute: async (_toolCallID, input, _signal, _onUpdate, ctx) => toolResult(await call(ctx, "monitor_start", input))
   });
   pi.registerCommand("sourcefed", {
-    description: "List Sourcefed monitors for the current Pi session",
+    description: "Show, stop, start, or delete Sourcefed monitors for the current Pi session",
     handler: async (_args, ctx) => {
-      const result = await call(ctx, "monitor_list", {});
-      const monitors = Array.isArray(result?.monitors) ? result.monitors : [];
+      const monitors = await listMonitors(ctx);
+      const run = async (action, id) => {
+        const result = await call(ctx, `monitor_${action}`, { id });
+        if (result?.ok === false) throw new Error(result.error ?? `monitor ${action} failed`);
+        void refreshStatus();
+        return listMonitors(ctx);
+      };
       await ctx.ui.custom(
-        (tui, theme, _keybindings, done) => showSourcefedDialog(tui, theme, done, `Sourcefed monitors (${monitors.length})`, monitorLines(monitors, theme))
+        (tui, theme, keybindings, done) => new MonitorManager(monitors, {
+          theme,
+          keys: keybindings,
+          run,
+          requestRender: () => tui.requestRender(),
+          close: () => done(null)
+        })
       );
     }
   });
@@ -185,9 +304,12 @@ async function sourcefedExtension(pi) {
       statusTimer = void 0;
     }
   }
-  async function updateStatus(ctx) {
+  async function listMonitors(ctx) {
     const result = await call(ctx, "monitor_list", {});
-    const monitors = Array.isArray(result?.monitors) ? result.monitors : [];
+    return Array.isArray(result?.monitors) ? result.monitors : [];
+  }
+  async function updateStatus(ctx) {
+    const monitors = await listMonitors(ctx);
     const active = monitors.filter((monitor) => monitor.enabled);
     if (active.length === 0) {
       ctx.ui.setStatus("sourcefed", void 0);