@sirenodeck/sirenodeck 0.1.1-alpha.0

package/src/builtin-addons/brightness/providers/linux.ts

@@ -0,0 +1,108 @@
+import type pino from "pino"
+
+import { type CommandExecutor } from "@/system/providers/shared"
+
+import {
+  createNullBrightnessProvider,
+  type BrightnessProvider,
+  type BrightnessReading,
+} from "./index"
+
+export interface CreateLinuxBrightnessProviderOptions {
+  readonly executor: CommandExecutor
+  readonly env?: Readonly<Record<string, string>>
+  readonly logger: pino.Logger
+}
+
+const parseXrandr = (stdout: string): BrightnessReading | null => {
+  const m = stdout.match(/Brightness:\s*([\d.]+)\s*\/\s*([\d.]+)/)
+  if (m === null) return null
+  const current = Number.parseFloat(m[1] ?? "")
+  const max = Number.parseFloat(m[2] ?? "")
+  if (!Number.isFinite(current) || !Number.isFinite(max) || max <= 0)
+    return null
+  return { value: Math.round((current / max) * 100), max: 100 }
+}
+
+const parseBrightnessCtl = (stdout: string): BrightnessReading | null => {
+  const v = Number.parseInt(stdout.trim(), 10)
+  if (!Number.isFinite(v)) return null
+  return { value: v, max: 100 }
+}
+
+export const createLinuxBrightnessProvider = (
+  options: CreateLinuxBrightnessProviderOptions,
+): BrightnessProvider => {
+  const { executor, env, logger } = options
+  const nullProvider = createNullBrightnessProvider(logger)
+  let disposed = false
+  const stop = async (): Promise<void> => {
+    disposed = true
+  }
+
+  const getCurrent = async (): Promise<BrightnessReading> => {
+    if (disposed) {
+      throw new Error("Brightness provider is disposed")
+    }
+    const envWayland = (env ?? process.env)["WAYLAND_DISPLAY"]
+    const isWayland =
+      envWayland !== undefined && envWayland.length > 0 && envWayland !== "0"
+    if (isWayland) {
+      const r = await executor.run("brightnessctl get", [])
+      if (r.exitCode === 0) {
+        const parsed = parseBrightnessCtl(r.stdout)
+        if (parsed !== null) return parsed
+      }
+    }
+    const r = await executor.run("xrandr --query", [])
+    if (r.exitCode !== 0) {
+      const fallback = await executor.run("brightnessctl get", [])
+      if (fallback.exitCode === 0) {
+        const parsed = parseBrightnessCtl(fallback.stdout)
+        if (parsed !== null) return parsed
+      }
+      logger.warn(
+        { exitCode: r.exitCode, stderr: r.stderr },
+        "brightness: xrandr + brightnessctl failed",
+      )
+      return nullProvider.getCurrent()
+    }
+    const parsed = parseXrandr(r.stdout)
+    if (parsed === null) {
+      logger.warn(
+        { stdout: r.stdout.slice(0, 200) },
+        "brightness: xrandr output not parseable",
+      )
+      return nullProvider.getCurrent()
+    }
+    return parsed
+  }
+
+  const setBrightness = async (value: number): Promise<void> => {
+    if (disposed) throw new Error("Brightness provider is disposed")
+    const clamped = Math.max(0, Math.min(100, Math.round(value)))
+    const setEnvWayland = (env ?? process.env)["WAYLAND_DISPLAY"]
+    const isWayland =
+      setEnvWayland !== undefined &&
+      setEnvWayland.length > 0 &&
+      setEnvWayland !== "0"
+    if (isWayland) {
+      const r = await executor.run("brightnessctl set", [`${clamped}%`])
+      if (r.exitCode === 0) return
+      logger.warn({ stderr: r.stderr }, "brightness: brightnessctl set failed")
+      return
+    }
+    const r = await executor.run("xrandr --output", [
+      "--brightness",
+      `${clamped / 100}`,
+    ])
+    if (r.exitCode !== 0) {
+      logger.warn(
+        { exitCode: r.exitCode, stderr: r.stderr },
+        "brightness: xrandr --brightness failed",
+      )
+    }
+  }
+
+  return { getCurrent, setBrightness, stop }
+}

package/src/builtin-addons/brightness/providers/windows.ts

@@ -0,0 +1,77 @@
+import type pino from "pino"
+
+import { type CommandExecutor } from "@/system/providers/shared"
+
+import {
+  createNullBrightnessProvider,
+  type BrightnessProvider,
+  type BrightnessReading,
+} from "./index"
+
+export interface CreateWindowsBrightnessProviderOptions {
+  readonly executor: CommandExecutor
+  readonly logger: pino.Logger
+}
+
+const parseWmi = (stdout: string): BrightnessReading | null => {
+  const v = Number.parseInt(stdout.trim(), 10)
+  if (!Number.isFinite(v)) return null
+  return { value: v, max: 100 }
+}
+
+export const createWindowsBrightnessProvider = (
+  options: CreateWindowsBrightnessProviderOptions,
+): BrightnessProvider => {
+  const { executor, logger } = options
+  const nullProvider = createNullBrightnessProvider(logger)
+  let disposed = false
+  const stop = async (): Promise<void> => {
+    disposed = true
+  }
+
+  const getCommand =
+    "(Get-WmiObject -Namespace root/WMI -ClassName WmiMonitorBrightness).CurrentBrightness"
+
+  const getCurrent = async (): Promise<BrightnessReading> => {
+    if (disposed) throw new Error("Brightness provider is disposed")
+    const r = await executor.run("powershell", [
+      "-NoProfile",
+      "-Command",
+      getCommand,
+    ])
+    if (r.exitCode !== 0) {
+      logger.warn(
+        { exitCode: r.exitCode, stderr: r.stderr },
+        "brightness: powershell get failed",
+      )
+      return nullProvider.getCurrent()
+    }
+    const parsed = parseWmi(r.stdout)
+    if (parsed === null) {
+      logger.warn(
+        { stdout: r.stdout.slice(0, 200) },
+        "brightness: powershell output not parseable",
+      )
+      return nullProvider.getCurrent()
+    }
+    return parsed
+  }
+
+  const setBrightness = async (value: number): Promise<void> => {
+    if (disposed) throw new Error("Brightness provider is disposed")
+    const clamped = Math.max(0, Math.min(100, Math.round(value)))
+    const r = await executor.run("powershell", [
+      "-NoProfile",
+      "-Command",
+      `(Get-WmiObject -Namespace root/WMI -ClassName WmiMonitorBrightness).CurrentBrightness = ${clamped}`,
+    ])
+    if (r.exitCode !== 0) {
+      logger.warn(
+        { exitCode: r.exitCode, stderr: r.stderr },
+        "brightness: powershell set failed",
+      )
+    }
+  }
+
+  return { getCurrent, setBrightness, stop }
+}

package/src/builtin-addons/brightness/sirenodeck.json

@@ -0,0 +1,6 @@
+{
+  "kind": "addon",
+  "apiVersion": 1,
+  "name": "brightness",
+  "entry": "index.ts"
+}

package/src/builtin-addons/coding-agents/assets/claude-code.svg

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8"?><svg width="800px" height="800px" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path fill="#d97706" d="m4.7144 15.9555 4.7174-2.6471.079-.2307-.079-.1275h-.2307l-.7893-.0486-2.6956-.0729-2.3375-.0971-2.2646-.1214-.5707-.1215-.5343-.7042.0546-.3522.4797-.3218.686.0608 1.5179.1032 2.2767.1578 1.6514.0972 2.4468.255h.3886l.0546-.1579-.1336-.0971-.1032-.0972L6.973 9.8356l-2.55-1.6879-1.3356-.9714-.7225-.4918-.3643-.4614-.1578-1.0078.6557-.7225.8803.0607.2246.0607.8925.686 1.9064 1.4754 2.4893 1.8336.3643.3035.1457-.1032.0182-.0728-.164-.2733-1.3539-2.4467-1.445-2.4893-.6435-1.032-.17-.6194c-.0607-.255-.1032-.4674-.1032-.7285L6.287.1335 6.6997 0l.9957.1336.419.3642.6192 1.4147 1.0018 2.2282 1.5543 3.0296.4553.8985.2429.8318.091.255h.1579v-.1457l.1275-1.706.2368-2.0947.2307-2.6957.0789-.7589.3764-.9107.7468-.4918.5828.2793.4797.686-.0668.4433-.2853 1.8517-.5586 2.9021-.3643 1.9429h.2125l.2429-.2429.9835-1.3053 1.6514-2.0643.7286-.8196.85-.9046.5464-.4311h1.0321l.759 1.1293-.34 1.1657-1.0625 1.3478-.8804 1.1414-1.2628 1.7-.7893 1.36.0729.1093.1882-.0183 2.8535-.607 1.5421-.2794 1.8396-.3157.8318.3886.091.3946-.3278.8075-1.967.4857-2.3072.4614-3.4364.8136-.0425.0304.0486.0607 1.5482.1457.6618.0364h1.621l3.0175.2247.7892.522.4736.6376-.079.4857-1.2142.6193-1.6393-.3886-3.825-.9107-1.3113-.3279h-.1822v.1093l1.0929 1.0686 2.0035 1.8092 2.5075 2.3314.1275.5768-.3218.4554-.34-.0486-2.2039-1.6575-.85-.7468-1.9246-1.621h-.1275v.17l.4432.6496 2.3436 3.5214.1214 1.0807-.17.3521-.6071.2125-.6679-.1214-1.3721-1.9246L14.38 17.959l-1.1414-1.9428-.1397.079-.674 7.2552-.3156.3703-.7286.2793-.6071-.4614-.3218-.7468.3218-1.4753.3886-1.9246.3157-1.53.2853-1.9004.17-.6314-.0121-.0425-.1397.0182-1.4328 1.9672-2.1796 2.9446-1.7243 1.8456-.4128.164-.7164-.3704.0667-.6618.4008-.5889 2.386-3.0357 1.4389-1.882.929-1.0868-.0062-.1579h-.0546l-6.3385 4.1164-1.1293.1457-.4857-.4554.0608-.7467.2307-.2429 1.9064-1.3114Z"/></svg>

package/src/builtin-addons/coding-agents/assets/opencode-dark-square.svg

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8"?><svg width="800px" height="800px" viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg"><rect width="512" height="512" fill="#131010"/><path d="M320 224V352H192V224H320Z" fill="#b4afaf"/><path fill-rule="evenodd" clip-rule="evenodd" d="M384 416H128V96H384V416ZM320 160H192V352H320V160Z" fill="white"/></svg>

package/src/builtin-addons/coding-agents/buttons/agent/backend.ts

@@ -0,0 +1,82 @@
+// ponytail: see packages/addons/app-shortcuts/src/index.ts for context.
+import type {
+  AddonButtonServiceContext,
+  AddonButtonTypeService,
+} from "../../types/types.js"
+import { configSchema, type AgentConfig } from "./config.js"
+import { agentAtSlot } from "../../shared/snapshot.js"
+import { agentKey } from "../../shared/state.js"
+import type { AgentsSnapshot, ProviderId } from "../../shared/state.js"
+
+const shq = (value: string): string => `'${value.replaceAll(`'`, `'\\''`)}'`
+
+// ponytail: focus can't reliably foreground the exact terminal/tmux pane an
+// agent runs in (no window-activation CLI on GNOME Wayland), so we spawn a
+// terminal in the session's project dir resuming it. claude --resume and
+// opencode --session N both support this. The launcher picks xdg-terminal-exec
+// then gnome-terminal; both accept `-- <cmd>`.
+const runFocus = async (
+  ctx: AddonButtonServiceContext<AgentConfig>,
+  agent: { providerId: ProviderId; sessionId: string; directory?: string },
+): Promise<void> => {
+  if (agent.sessionId.startsWith("instance:")) return
+  const dir = agent.directory
+  const prefix = dir && dir.length > 0 ? `cd ${shq(dir)} && ` : ""
+  const resume =
+    agent.providerId === "opencode"
+      ? `${prefix}opencode --session ${shq(agent.sessionId)}`
+      : `${prefix}claude --resume ${shq(agent.sessionId)}`
+  const cmd =
+    `t=$(command -v xdg-terminal-exec || command -v gnome-terminal); ` +
+    `[ -n "$t" ] && nohup "$t" -- bash -c ${shq(resume)} >/dev/null 2>&1 &`
+  await ctx.executor.run(cmd)
+}
+
+const methodsFor = (ctx: AddonButtonServiceContext<AgentConfig>) =>
+  ctx.methods as Readonly<Record<string, (...args: unknown[]) => unknown>>
+
+const resolveSlotAgent = (
+  ctx: AddonButtonServiceContext<AgentConfig>,
+): { providerId: ProviderId; sessionId: string; directory?: string } | null => {
+  const get = methodsFor(ctx)["coding-agents:getSnapshot"]
+  if (typeof get !== "function") return null
+  const snapshot = get() as AgentsSnapshot | undefined
+  if (!snapshot) return null
+  const agent = agentAtSlot(snapshot, ctx.config?.slot ?? 0)
+  return agent
+    ? {
+        providerId: agent.providerId,
+        sessionId: agent.sessionId,
+        directory: agent.directory,
+      }
+    : null
+}
+
+const callDismiss = (ctx: AddonButtonServiceContext<AgentConfig>): void => {
+  const dismiss = methodsFor(ctx)["coding-agents:dismissAttention"]
+  if (typeof dismiss === "function") {
+    const agent = resolveSlotAgent(ctx)
+    if (agent) {
+      ;(dismiss as (a: string) => unknown)(agentKey(agent))
+    }
+  }
+}
+
+// ponytail: tap is reserved for the frontend's PaginatedSurface page
+// cycling; hold opens the session, dbl-tap dismisses the attention notice.
+export default {
+  configSchema,
+  gestureHandlers: ["tap", "hold", "dbl-tap"] as const,
+  onMount: (_ctx: AddonButtonServiceContext<AgentConfig>): void => {},
+  onTap: (_ctx: AddonButtonServiceContext<AgentConfig>): void => {},
+  onHold: async (
+    ctx: AddonButtonServiceContext<AgentConfig>,
+  ): Promise<void> => {
+    const agent = resolveSlotAgent(ctx)
+    if (agent) await runFocus(ctx, agent)
+  },
+  onDblTap: (ctx: AddonButtonServiceContext<AgentConfig>): void => {
+    callDismiss(ctx)
+  },
+  dispose: (_ctx: AddonButtonServiceContext<AgentConfig>): void => {},
+} satisfies AddonButtonTypeService<AgentConfig>

package/src/builtin-addons/coding-agents/buttons/agent/config.ts

@@ -0,0 +1,13 @@
+import { z } from "zod"
+
+export const configSchema = z
+  .object({
+    // ponytail: slot tiles are materialized once; which agent a slot shows
+    // is resolved from the live snapshot (agentAtSlot). Explicit
+    // providerId/sessionId pinning was never reachable (button ids are
+    // positional), so it's gone.
+    slot: z.number().int().min(0).default(0),
+  })
+  .strict()
+
+export type AgentConfig = z.infer<typeof configSchema>

package/src/builtin-addons/coding-agents/buttons/agent/frontend.tsx

@@ -0,0 +1,130 @@
+import { PaginatedSurface, type PaginatedPage } from "@/ui"
+
+import type { AddonFrontendButtonProps } from "../../types/types.js"
+
+import type { AgentConfig } from "./config.js"
+import {
+  AgentContextPage,
+  AgentDetailsPage,
+  AgentMetricsPage,
+  CurrentAgentPage,
+} from "./pages.js"
+
+const AUTO_RETURN_MS = 10_000
+
+const CHANNEL_NAME = "coding-agents:agents"
+
+declare global {
+  // ponytail: see summary/frontend.tsx — host-injected channel hook,
+  // looked up lazily so test environments without it still typecheck.
+  // eslint-disable-next-line no-var
+  var __codingAgentsUseAddonChannel:
+    | (<T>(channel: string) => { data: T | undefined })
+    | undefined
+}
+
+const useAddonChannel = <T,>(channel: string): { data: T | undefined } => {
+  const hook = globalThis.__codingAgentsUseAddonChannel
+  return hook ? hook<T>(channel) : { data: undefined }
+}
+
+interface AgentLike {
+  sessionId: string
+  providerId: string
+  title: string
+  status: string
+  directory?: string
+  cost?: number
+  contextTokens?: number
+  contextPercent?: number
+  createdAt?: number
+  updatedAt?: number
+  lastMessagePreview?: string
+}
+
+interface SnapshotLike {
+  byProvider?: Record<string, AgentLike[]>
+  icons?: Record<string, string>
+}
+
+// ponytail: solid status color underlay at fixed opacity — unlike color-mix
+// it's universally supported (emulator + headless hardware screenshots).
+// idle stays transparent so stale sessions read as quiet.
+const TILE_COLOR: Record<string, string> = {
+  idle: "transparent",
+  running: "var(--sireno-color-primary)",
+  waiting: "var(--sireno-variant-amber-primary, #fbbf24)",
+  waiting_for_human: "var(--sireno-variant-amber-primary, #fbbf24)",
+  error: "var(--sireno-color-danger)",
+  compacting: "var(--sireno-color-primary)",
+}
+
+const DOT_COLOR: Record<string, string> = {
+  idle: "var(--sireno-variant-default-muted, #9ca3af)",
+  running: "var(--sireno-color-primary)",
+  waiting: "var(--sireno-variant-amber-primary, #fbbf24)",
+  waiting_for_human: "var(--sireno-variant-amber-primary, #fbbf24)",
+  error: "var(--sireno-color-danger)",
+  compacting: "var(--sireno-color-primary)",
+}
+
+const agentAt = (snapshot: SnapshotLike, slot: number): AgentLike | null => {
+  const all: AgentLike[] = []
+  for (const list of Object.values(snapshot.byProvider ?? {})) all.push(...list)
+  // keep in sync with byCreatedDesc in shared/snapshot.ts so the slot a tile
+  // renders matches the slot the backend resolves for gestures
+  all.sort(
+    (x, y) =>
+      (y.createdAt ?? 0) - (x.createdAt ?? 0) ||
+      (y.updatedAt ?? 0) - (x.updatedAt ?? 0),
+  )
+  return all[slot] ?? null
+}
+
+const AgentFrontend = (props: AddonFrontendButtonProps<AgentConfig>) => {
+  const { data } = useAddonChannel<SnapshotLike>(CHANNEL_NAME)
+  const snapshot = data ?? { byProvider: {} }
+  const slot = props.config?.slot ?? 0
+  const agent = agentAt(snapshot, slot)
+
+  const status = agent?.status ?? "idle"
+  const tileColor = TILE_COLOR[status] ?? TILE_COLOR["idle"]!
+  const dotColor = DOT_COLOR[status] ?? DOT_COLOR["idle"]!
+  const title = agent?.title ?? (slot === 0 ? "no agents" : "")
+  const iconSource = agent ? snapshot.icons?.[agent.providerId] : undefined
+
+  // ponytail: empty slots (no live session for this tile) read as blank —
+  // trailing tiles of the paginated deck stay quiet.
+  if (agent === null && slot !== 0) {
+    return <div className="h-full w-full" />
+  }
+
+  const pageProps = {
+    title,
+    sessionId: agent?.sessionId,
+    directory: agent?.directory,
+    lastMessagePreview: agent?.lastMessagePreview,
+    status,
+    iconSource,
+    cost: agent?.cost,
+    contextTokens: agent?.contextTokens,
+    contextPercent: agent?.contextPercent,
+    tileColor,
+    dotColor,
+  }
+  const pages: PaginatedPage<typeof pageProps>[] = [
+    { render: CurrentAgentPage, config: pageProps },
+    { render: AgentMetricsPage, config: pageProps },
+    { render: AgentContextPage, config: pageProps },
+    { render: AgentDetailsPage, config: pageProps },
+  ]
+  return (
+    <PaginatedSurface
+      pages={pages}
+      gesture={props.gesture}
+      autoReturnMs={AUTO_RETURN_MS}
+    />
+  )
+}
+
+export default AgentFrontend

package/src/builtin-addons/coding-agents/buttons/agent/pages.tsx

@@ -0,0 +1,150 @@
+import { Icon } from "@sirenodeck/sirenodeck"
+import type { ReactElement } from "react"
+
+import { LabelValueListSurface } from "@/ui"
+
+interface AgentPageProps {
+  title: string
+  sessionId?: string
+  directory?: string
+  lastMessagePreview?: string
+  status: string
+  iconSource?: string
+  cost?: number
+  contextTokens?: number
+  contextPercent?: number
+  tileColor: string
+  dotColor: string
+}
+
+const value = (n: number | undefined, suffix = ""): string =>
+  typeof n === "number" && Number.isFinite(n) ? `${n}${suffix}` : "---"
+
+// ponytail: compact token counts — k, M, kM (european milliard, 10^9),
+// MM (european billion, 10^12).
+const TOKEN_UNITS: ReadonlyArray<[number, string]> = [
+  [1_000_000_000_000, "MM"],
+  [1_000_000_000, "kM"],
+  [1_000_000, "M"],
+  [1_000, "k"],
+]
+
+export const formatTokens = (tokens: number | undefined): string => {
+  if (typeof tokens !== "number" || !Number.isFinite(tokens)) return "---"
+  let n = tokens
+  for (const [factor, unit] of TOKEN_UNITS) {
+    if (Math.abs(n) < factor) continue
+    const scaled = n / factor
+    if (Math.round(scaled) >= 1000) continue
+    const rounded =
+      scaled >= 10 || scaled <= -10
+        ? Math.round(scaled)
+        : Math.round(scaled * 10) / 10
+    return `${rounded}${unit}`
+  }
+  return `${Math.round(n)}`
+}
+
+const formatCost = (cost: number | undefined): string =>
+  typeof cost === "number" && Number.isFinite(cost) && cost >= 0
+    ? `$${cost.toFixed(2)}`
+    : "---"
+
+const shortPath = (directory: string | undefined): string => {
+  if (directory === undefined || directory.length === 0) return "---"
+  return directory.split(/[\\/]/).at(-1) || directory
+}
+
+const shortSessionId = (sessionId: string | undefined): string =>
+  sessionId === undefined || sessionId.length === 0
+    ? "---"
+    : sessionId.slice(-8)
+
+export const CurrentAgentPage = ({
+  title,
+  status,
+  iconSource,
+  tileColor,
+  dotColor,
+}: AgentPageProps): ReactElement => (
+  <div className="relative flex h-full w-full flex-col justify-between p-1">
+    {tileColor !== "transparent" && (
+      <div
+        className="pointer-events-none absolute -inset-[5px] z-0 rounded-2xl"
+        style={{ backgroundColor: tileColor, opacity: 0.32 }}
+      />
+    )}
+    <div className="relative z-10 grid min-w-0 flex-1 grid-cols-[auto_minmax(0,1fr)] grid-rows-[auto_repeat(3,minmax(0,1fr))] items-center gap-x-1 py-0">
+      {iconSource !== undefined ? (
+        <span>
+          <Icon source={iconSource} size={18} />
+        </span>
+      ) : (
+        <span
+          className="inline-block h-3 w-3 shrink-0 rounded-full"
+          style={{ backgroundColor: dotColor }}
+          aria-label={status}
+        />
+      )}
+      <span className="min-w-0 truncate text-[10px] font-medium uppercase opacity-80">
+        {status}
+      </span>
+      <span className="col-span-2 row-span-3 row-start-2 min-w-0 overflow-clip text-sm font-semibold leading-tight [display:-webkit-box] [-webkit-box-orient:vertical] [-webkit-line-clamp:3]">
+        {title || <span className="opacity-40">empty</span>}
+      </span>
+    </div>
+  </div>
+)
+
+export const AgentMetricsPage = ({
+  cost,
+  contextTokens,
+}: AgentPageProps): ReactElement => (
+  <LabelValueListSurface
+    lines={[
+      { label: "cost", value: formatCost(cost), icon: "icon://coins" },
+      {
+        label: "tokens",
+        value: formatTokens(contextTokens),
+        icon: "icon://activity",
+      },
+    ]}
+  />
+)
+
+export const AgentContextPage = ({
+  contextPercent,
+  directory,
+}: AgentPageProps): ReactElement => (
+  <LabelValueListSurface
+    lines={[
+      {
+        label: "context",
+        value: value(contextPercent),
+        units: "%",
+        icon: "icon://cpu",
+      },
+      { label: "project", value: shortPath(directory), icon: "icon://folder" },
+    ]}
+  />
+)
+
+export const AgentDetailsPage = ({
+  sessionId,
+  lastMessagePreview,
+}: AgentPageProps): ReactElement => (
+  <LabelValueListSurface
+    lines={[
+      {
+        label: "session",
+        value: shortSessionId(sessionId),
+        icon: "icon://clock",
+      },
+      {
+        label: "activity",
+        value: lastMessagePreview ?? "---",
+        icon: "icon://terminal",
+      },
+    ]}
+  />
+)

package/src/builtin-addons/coding-agents/buttons/summary/backend.ts

@@ -0,0 +1,48 @@
+// ponytail: see packages/addons/app-shortcuts/src/index.ts for context.
+import type {
+  AddonButtonServiceContext,
+  AddonButtonTypeService,
+} from "../../types/types.js"
+
+import { AGENTS_DECK_BASE } from "../../shared/live-count.js"
+import { configSchema, type SummaryConfig } from "./config.js"
+
+interface CoreMethodsShape {
+  navigateToDeck: (args: { id: string; addToHistory?: boolean }) => void
+}
+
+const methodsFor = (ctx: AddonButtonServiceContext<SummaryConfig>) =>
+  ctx.methods as Readonly<Record<string, (...args: unknown[]) => unknown>>
+
+// ponytail: the agents deck is dynamic (pages depend on live session count),
+// so the navigation target resolves from the global service at tap time —
+// `-p1` when paginated, the base id when a single page exists.
+const deckTargetFor = (
+  ctx: AddonButtonServiceContext<SummaryConfig>,
+): string => {
+  const get = methodsFor(ctx)["coding-agents:getDeckTarget"]
+  if (typeof get === "function") {
+    const target = get() as unknown
+    if (typeof target === "string" && target.length > 0) return target
+  }
+  return AGENTS_DECK_BASE
+}
+
+export default {
+  configSchema,
+  gestureHandlers: ["tap"] as const,
+  onMount: (_ctx: AddonButtonServiceContext<SummaryConfig>): void => {},
+  onTap: (ctx: AddonButtonServiceContext<SummaryConfig>): void => {
+    const target = deckTargetFor(ctx)
+    const core = ctx.coreMethods as CoreMethodsShape | undefined
+    if (core?.navigateToDeck) {
+      core.navigateToDeck({ id: target, addToHistory: true })
+      return
+    }
+    const fallback = methodsFor(ctx)["coding-agents:open"]
+    if (typeof fallback === "function") {
+      ;(fallback as (a: { id: string }) => void)({ id: target })
+    }
+  },
+  dispose: (_ctx: AddonButtonServiceContext<SummaryConfig>): void => {},
+} satisfies AddonButtonTypeService<SummaryConfig>

package/src/builtin-addons/coding-agents/buttons/summary/config.ts

@@ -0,0 +1,11 @@
+import { z } from "zod"
+
+export const configSchema = z
+  .object({
+    showCount: z.boolean().default(true),
+    attentionOnly: z.boolean().default(false),
+    fallingLetters: z.boolean().default(true),
+  })
+  .strict()
+
+export type SummaryConfig = z.infer<typeof configSchema>