@g3nomaly/g3n-mods 0.1.7 → 0.1.8

package/mods/custom-crab-agents/hooks/register.tsx

@@ -12,6 +12,20 @@ const PANEL = 'agents-panel'
 /** Key prefix of the agents panel's own elements, and the one this section carries so the panel shows it. */
 const PANEL_KEY = 'agents:'
 const ADDON_KEY = 'addon:'
+
+/** Prop the mods viewer adds to every pane it draws; the Claude Code extension draws on the `vscode` surface too, without it. */
+const VIEWER_PROP = 'g3nViewer'
+
+/**
+ * Tells whether the mods viewer asked for this drawing, rather than the Claude Code extension on the same surface.
+ *
+ * @param props - The `Pane` props of the `ui.render` argument.
+ * @returns `true` when the viewer's prop is set.
+ */
+function isViewer(props: object): boolean {
+  return (props as Readonly<Record<string, unknown>>)[VIEWER_PROP] === true
+}
+
 const crabs = atom({ plugin: 'custom-crab-agents', key: 'crabs' } as const, [])
 const planned = atom({ plugin: 'custom-crab-agents', key: 'planned' } as const, [])
 const contextWindow = atom({ plugin: 'custom-crab-agents', key: 'window' } as const, 1_000_000)
@@ -592,7 +606,7 @@ export const register: Register = on => {
     const now = await $.clock.now()
 
     // The viewer draws the crabs with the mod's own view: hand it the cards as data, inside the key the panel looks for.
-    if (e.surface === 'vscode') {
+    if (e.surface === 'vscode' && isViewer(e.props)) {
       const { Input } = $.ui.resolve(e)
       const data: CrabsViewData = {
         crabs: list.map(crab => {

package/mods/delete-guard/.claude-plugin/plugin.json

@@ -5,5 +5,13 @@
   "author": {
     "name": "g3ntrovert"
   },
-  "types": "./types/index.d.ts"
+  "types": "./types/index.d.ts",
+  "userConfig": {
+    "showInClaudeCode": {
+      "type": "boolean",
+      "title": "Show in Claude Code",
+      "default": false,
+      "description": "Open this mod's pane in the Claude Code chat when a session starts. The mods viewer shows it either way."
+    }
+  }
 }

package/mods/delete-guard/hooks/register.tsx

@@ -424,6 +424,9 @@ const held: Held[] = []
 /** The card lists every file instead of the first `SHOWN_FILES`. */
 let isExpanded = false
 
+/** The switch stays in the Claude Code chat; else only a waiting delete's card shows there. Set from the plugin options. */
+let isShownInChat = false
+
 /**
  * Turns the guard on or off, for this session and every later one.
  *
@@ -436,12 +439,16 @@ async function setGuard($: EngineInterface, isGuarding: boolean): Promise<void>
 }
 
 /**
- * Shows the switch again once no delete waits: the pane's title goes back from the card's.
+ * Shows the switch again once no delete waits: the pane's title goes back from the card's, or the pane leaves the
+ * Claude Code chat when the switch is not shown there.
  *
  * @param $ - Engine handle the hook received.
  */
 async function showSwitch($: EngineInterface): Promise<void> {
-  if (held.length === 0) await $.ui.open({ id: PANE, title: TITLE }).catch(() => undefined)
+  if (held.length === 0) {
+    if (isShownInChat) await $.ui.open({ id: PANE, title: TITLE }).catch(() => undefined)
+    else await $.ui.close({ id: PANE }).catch(() => undefined)
+  }
   $.ui.invalidate('ui.render')
 }
 
@@ -483,7 +490,8 @@ async function hold($: EngineInterface, card: Omit<Held, 'settle'>, signal: Abor
   const onAbort = (): void => drop('cancel')
   signal?.addEventListener('abort', onAbort, { once: true })
 
-  // The switch's pane is usually open already: retitle and focus it, then redraw it as the card.
+  // A delete waits on an answer, so its card opens in the Claude Code chat whatever the option says: retitle and focus
+  // the switch's pane when it is open already, then redraw it as the card.
   if (held.length === 1) await $.ui.open({ id: PANE, title: HOLD_TITLE, focus: true })
   $.ui.invalidate('ui.render')
 
@@ -508,8 +516,10 @@ async function hold($: EngineInterface, card: Omit<Held, 'settle'>, signal: Abor
  * Registers this mod's `delete-guard` command, its session hook, its Bash tool hook, and its pane: the switch, or the card while a delete waits.
  *
  * @param on - Hook registration function the engine passes in.
+ * @param options - Plugin options; `showInClaudeCode` keeps the switch in the Claude Code chat.
  */
-export const register: Register = on => {
+export const register: Register = (on, options) => {
+  isShownInChat = options.showInClaudeCode === true
   let trash: string | undefined
   let home = ''
 
@@ -524,7 +534,7 @@ export const register: Register = on => {
       description: 'Turn the permanent-delete guard on or off; it stays that way in later sessions',
       argumentHint: 'on | off',
     })
-    void $.ui.open({ id: PANE, title: TITLE })
+    if (isShownInChat) void $.ui.open({ id: PANE, title: TITLE })
     return next(e)
   })
 

package/mods/delete-guard/view/panes.json

@@ -0,0 +1,8 @@
+{
+  "panes": [
+    {
+      "id": "delete-guard",
+      "title": "Delete guard"
+    }
+  ]
+}

package/mods/focus-mode/.claude-plugin/plugin.json

@@ -12,6 +12,12 @@
       "title": "Minutes",
       "default": 25,
       "description": "Length of a focus block in minutes"
+    },
+    "showInClaudeCode": {
+      "type": "boolean",
+      "title": "Show in Claude Code",
+      "default": false,
+      "description": "Open this mod's pane in the Claude Code chat when a session starts. The mods viewer shows it either way."
     }
   }
 }

package/mods/focus-mode/hooks/register.tsx

@@ -81,7 +81,7 @@ async function setLength($: EngineInterface, minutes: number): Promise<void> {
 }
 
 /**
- * Starts a block of `minutes`, replacing one already running, and shows the pane.
+ * Starts a block of `minutes`, replacing one already running.
  *
  * @param $ - Engine handle the hook received, see `EngineInterface`.
  * @param minutes - Length of the block in minutes.
@@ -89,7 +89,7 @@ async function setLength($: EngineInterface, minutes: number): Promise<void> {
 async function startFocus($: EngineInterface, minutes: number): Promise<void> {
   const startedAt = await $.clock.now()
   await update($, block, () => ({ startedAt, endsAt: startedAt + minutes * 60_000, minutes }))
-  await $.ui.open({ id: PANE, title: TITLE })
+  $.ui.invalidate('ui.render')
 }
 
 /**
@@ -144,7 +144,8 @@ async function awayBlock($: EngineInterface): Promise<FocusBlock | null> {
  * from asking anything during a block: questions are refused, and so are permission prompts.
  *
  * @param on - Hook registration function the engine passes in.
- * @param options - Plugin options; `minutes` sets the default block length.
+ * @param options - Plugin options; `minutes` sets the default block length, `showInClaudeCode` opens the pane in the
+ *   Claude Code chat at session start.
  */
 export const register: Register = (on, options) => {
   const configured = Number(options.minutes ?? DEFAULT_MINUTES)
@@ -158,7 +159,7 @@ export const register: Register = (on, options) => {
       description: 'Start a focus block in which Claude asks you nothing (the length you set, or the minutes given), or end the running one',
       argumentHint: '[minutes] | end',
     })
-    void $.ui.open({ id: PANE, title: TITLE })
+    if (options.showInClaudeCode === true) void $.ui.open({ id: PANE, title: TITLE })
     $.clock.every(1000, () => void tick($))
     return next(e)
   })
@@ -177,6 +178,8 @@ export const register: Register = (on, options) => {
     // A length typed with the command becomes the one the pane starts with next time.
     if (arg !== '') await setLength($, minutes)
     await startFocus($, minutes)
+    // Typed in the chat, so the countdown shows there too.
+    await $.ui.open({ id: PANE, title: TITLE })
     return { text: `Focus block started: ${minutes} min.` }
   })
 

package/mods/focus-mode/view/panes.json

@@ -0,0 +1,8 @@
+{
+  "panes": [
+    {
+      "id": "focus-mode",
+      "title": "Focus"
+    }
+  ]
+}

package/mods/mini-game/.claude-plugin/plugin.json

@@ -5,5 +5,13 @@
   "author": {
     "name": "g3ntrovert"
   },
-  "types": "./types/index.d.ts"
+  "types": "./types/index.d.ts",
+  "userConfig": {
+    "showInClaudeCode": {
+      "type": "boolean",
+      "title": "Show in Claude Code",
+      "default": false,
+      "description": "Open this mod's pane in the Claude Code chat when a session starts. The mods viewer shows it either way."
+    }
+  }
 }

package/mods/mini-game/hooks/register.tsx

@@ -27,7 +27,7 @@ const CELL_WIDTH = 2
 const NUMBER_COLORS = [undefined, '#6b8fd6', '#7cc47f', '#e06c6c', '#9b87f5', '#e0775a', '#5fb3c4', '#d0d0d0', '#8a8f98']
 
 /**
- * Shows the pane, titled after the game it holds.
+ * Opens the pane in the Claude Code chat, titled after the game it holds.
  *
  * @param $ - Engine handle the hook received, see `EngineInterface`.
  */
@@ -36,14 +36,25 @@ async function openPane($: EngineInterface): Promise<void> {
 }
 
 /**
- * Starts a new Minesweeper board and shows the pane.
+ * Titles the pane after the game it holds where the Claude Code chat shows it, and redraws it. A press never opens
+ * it there: a pane the mods viewer alone draws stays out of the chat.
+ *
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
+ */
+async function showGame($: EngineInterface): Promise<void> {
+  if ((await $.ui.panes()).some(pane => pane.id === PANE)) await openPane($)
+  else $.ui.invalidate('ui.render')
+}
+
+/**
+ * Starts a new Minesweeper board and shows it.
  *
  * @param $ - Engine handle the hook received, see `EngineInterface`.
  */
 async function startGame($: EngineInterface): Promise<void> {
   const now = await $.clock.now()
   await update($, game, () => newGame(now))
-  await openPane($)
+  await showGame($)
 }
 
 /**
@@ -57,13 +68,13 @@ async function showView($: EngineInterface, next: View): Promise<void> {
   await update($, view, () => next)
   if (next === 'mole') {
     await update($, whack, current => current ?? newWhack())
-    await openPane($)
+    await showGame($)
     return
   }
   await changeWhack($, quit)
   const current = await read($, game)
   if (current === null || current.status === 'won' || current.status === 'lost') await startGame($)
-  else await openPane($)
+  else await showGame($)
 }
 
 /**
@@ -161,15 +172,16 @@ async function hint($: EngineInterface, turnId: string): Promise<void> {
  * Registers this mod's `mini-game` command, its session, turn and pane hooks.
  *
  * @param on - Hook registration function the engine passes in.
+ * @param options - Plugin options; `showInClaudeCode` opens the pane in the Claude Code chat at session start.
  */
-export const register: Register = on => {
+export const register: Register = (on, options) => {
   on('session.start', async ($, e, next) => {
     await $.command.register({ name: 'mini-game', description: 'Play Minesweeper or whack-a-mole while Claude works' })
     const storedBest = await $.store.get(BEST_KEY)
     if (typeof storedBest === 'number') await update($, best, () => storedBest)
     const storedWhackBest = await $.store.get(WHACK_BEST_KEY)
     if (typeof storedWhackBest === 'number') await update($, whackBest, () => storedWhackBest)
-    void openPane($)
+    if (options.showInClaudeCode === true) void openPane($)
     $.clock.every(1000, () => void tick($))
     return next(e)
   })
@@ -179,6 +191,8 @@ export const register: Register = on => {
     const next = arg === '' ? await read($, view) : VIEW_ARGS[arg]
     if (next === undefined) return { text: `Unknown game "${arg}". Use /mini-game mines or /mini-game mole.`, exitCode: 1 }
     await showView($, next)
+    // Typed in the chat, so the game shows there too.
+    await openPane($)
     return {
       text: next === 'mines'
         ? 'Minesweeper is open. Clear the board without hitting a mine.'

package/mods/mini-game/view/panes.json

@@ -0,0 +1,8 @@
+{
+  "panes": [
+    {
+      "id": "mini-game",
+      "title": "Mini game"
+    }
+  ]
+}

package/mods/tool-timeline/.claude-plugin/plugin.json

@@ -5,5 +5,13 @@
   "author": {
     "name": "g3ntrovert"
   },
-  "types": "./types/index.d.ts"
+  "types": "./types/index.d.ts",
+  "userConfig": {
+    "showInClaudeCode": {
+      "type": "boolean",
+      "title": "Show in Claude Code",
+      "default": false,
+      "description": "Open this mod's pane in the Claude Code chat when a session starts. The mods viewer shows it either way."
+    }
+  }
 }

package/mods/tool-timeline/hooks/register.tsx

@@ -12,6 +12,19 @@ const selected = atom({ plugin: 'tool-timeline', key: 'selected' } as const, '')
 /** Calls kept in state; older ones fall off. */
 const KEEP = 100
 
+/** Prop the mods viewer adds to every pane it draws; the Claude Code extension draws on the `vscode` surface too, without it. */
+const VIEWER_PROP = 'g3nViewer'
+
+/**
+ * Tells whether the mods viewer asked for this drawing, rather than the Claude Code extension on the same surface.
+ *
+ * @param props - The `Pane` props of the `ui.render` argument.
+ * @returns `true` when the viewer's prop is set.
+ */
+function isViewer(props: object): boolean {
+  return (props as Readonly<Record<string, unknown>>)[VIEWER_PROP] === true
+}
+
 /** Approximate pixel width of one cell of the editor's code font. */
 const CELL_PX = 7
 
@@ -250,11 +263,12 @@ async function toggleSelected($: EngineInterface, id: string): Promise<void> {
  * @brief Subscribes the timeline's handlers to the engine's events, its command and its pane.
  *
  * @param on - Subscribes a handler to one engine event, optionally filtered.
+ * @param options - Plugin options; `showInClaudeCode` opens the pane in the Claude Code chat at session start.
  */
-export const register: Register = on => {
+export const register: Register = (on, options) => {
   on('session.start', async ($, e, next) => {
-    await $.command.register({ name: 'tool-timeline', description: 'Show or hide the tool call timeline' })
-    void $.ui.open({ id: PANE, title: TITLE })
+    await $.command.register({ name: 'tool-timeline', description: 'Show or hide the tool call timeline in the Claude Code chat' })
+    if (options.showInClaudeCode === true) void $.ui.open({ id: PANE, title: TITLE })
     $.clock.every(1000, () => void tick($))
     return next(e)
   })
@@ -329,7 +343,7 @@ export const register: Register = on => {
     const axis = placeCalls(shown, now)
 
     // The viewer draws the timeline with the mod's own view: hand it the calls as data.
-    if (e.surface === 'vscode') {
+    if (e.surface === 'vscode' && isViewer(e.props)) {
       const { Input } = $.ui.resolve(e)
       const spans = screenSpans(list, now)
       const data: TimelineViewData = {

package/mods/tool-timeline/view/panes.json

@@ -0,0 +1,8 @@
+{
+  "panes": [
+    {
+      "id": "tool-timeline",
+      "title": "Tool timeline"
+    }
+  ]
+}

package/mods/you-should-know/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "you-should-know",
   "version": "0.1.0",
-  "description": "A card under long replies that flags their key point: a headline and one supporting line.",
+  "description": "A compact card under a reply: the questions it asks you word for word, and for long replies what changed and what it concluded, each line tagged.",
   "author": {
     "name": "g3ntrovert"
   },
@@ -10,8 +10,8 @@
     "minChars": {
       "type": "number",
       "title": "Minimum reply length",
-      "default": 1500,
-      "description": "Replies shorter than this many characters get no card"
+      "default": 800,
+      "description": "Replies shorter than this many characters get no changes, conclusions or facts; their questions still show"
     },
     "model": {
       "type": "string",