@npv12/opencode-mini-session 0.0.1

package/README.md

@@ -0,0 +1,77 @@
+# opencode-mini-session
+
+OpenCode V2 TUI plugin that creates ephemeral mini sessions for side questions. Ask quick questions without disrupting your main conversation.
+
+## Features
+
+- **Mini sessions** — ephemeral child sessions that auto-clean on close
+- **Context copying** — optionally copies main session context into the mini prompt
+- **Model picker** — switch between models for mini-session questions (Tab)
+- **Streaming answers** — real-time streaming with markdown rendering
+- **Continue in main thread** — paste mini session transcript back into main session
+- **Thinking mode** — toggle extended thinking with Ctrl+T
+- **Hide/show** — toggle the overlay without closing the session
+
+## Installation
+
+Requires OpenCode `0.0.0-beta-17963` or compatible.
+
+```bash
+opencode2 plugin add opencode-mini-session
+```
+
+Or add to your `cli.json`:
+
+```json
+{
+  "plugins": ["./path/to/opencode-mini-session/src/index.ts"]
+}
+```
+
+## Configuration
+
+Pass options in your `opencode.json(c)`:
+
+```json
+{
+  "plugins": [
+    {
+      "package": "opencode-mini-session",
+      "options": {
+        "model": "anthropic/claude-sonnet-4-5",
+        "keybind": "alt+b",
+        "freshKeybind": "alt+n",
+        "enableThinking": false,
+        "tokenLimit": 50000
+      }
+    }
+  ]
+}
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `model` | (session default) | Override model for mini sessions (`provider/model`) |
+| `variant` | — | Model variant to use |
+| `agent` | — | Custom agent name (falls back to plugin-managed mode if not found) |
+| `keybind` | `alt+b` | Global keybind to toggle mini session (set `false` to disable) |
+| `freshKeybind` | `alt+n` | Keybind for mini session without copied context |
+| `enableThinking` | `false` | Default thinking state for mini sessions |
+| `toggleThinkingKeybind` | `ctrl+t` | Keybind to toggle thinking in the mini dialog |
+| `tokenLimit` | `50000` | Max tokens to copy from main session context |
+
+## Commands
+
+| Command | Slash | Description |
+|---------|-------|-------------|
+| `mini` | `/mini` | Open mini session with main session context |
+| `mini fresh` | `/mini-fresh` | Open mini session without copied context |
+| `mini model` | `/mini-model` | Change model for future mini sessions |
+
+## Attribution
+
+Based on [karamanliev/opencode-mini-session](https://github.com/karamanliev/opencode-mini-session).
+
+## License
+
+MIT

package/dist/agent.js

@@ -0,0 +1,103 @@
+import { formatResolvedModel } from "./model.js";
+const MINI_SIDE_QUESTION_INSTRUCTION = "You are answering a quick side question about an ongoing coding session. Below is the conversation context from the session. Answer concisely based on what you can see.";
+const MINI_FRESH_INSTRUCTION = "You are answering a quick side question about an ongoing coding session. No conversation context from the main session has been copied into this mini session. Answer concisely based only on the current mini-session messages and any tools or files you inspect.";
+const MINI_TOOL_NOTE = " You may only use the following tools: glob, grep, list, read, webfetch. Do not attempt to use any other tools.";
+export function resolveRuntimeMiniAgent(context, config) {
+  const agents = context.data.location.agent.list();
+  const mode = resolveMiniAgentMode(config, agents ? [...agents] : null);
+  return buildResolvedMiniAgent(config, mode);
+}
+export function resolveMiniAgent(config, agents) {
+  return buildResolvedMiniAgent(config, resolveMiniAgentMode(config, agents));
+}
+export function resolveMiniAgentMode(config, agents) {
+  if (!config.agent) return {
+    mode: "plugin-managed",
+    requestedAgent: null
+  };
+  if (agents === null) return {
+    mode: "plugin-managed",
+    requestedAgent: config.agent,
+    unavailableAgent: config.agent
+  };
+  const match = agents.find(a => a.name === config.agent);
+  if (match) return {
+    mode: "custom-agent",
+    requestedAgent: config.agent,
+    agent: match.name
+  };
+  return {
+    mode: "plugin-managed",
+    requestedAgent: config.agent,
+    missingAgent: config.agent
+  };
+}
+export function buildResolvedMiniAgent(config, mode) {
+  if (mode.mode === "custom-agent") {
+    return {
+      mode: "custom-agent",
+      requestedAgent: mode.requestedAgent,
+      agent: mode.agent,
+      notices: buildMiniAgentNotices(config, mode)
+    };
+  }
+  return {
+    mode: "plugin-managed",
+    requestedAgent: mode.requestedAgent,
+    missingAgent: mode.missingAgent,
+    unavailableAgent: mode.unavailableAgent,
+    notices: buildMiniAgentNotices(config, mode)
+  };
+}
+export function buildMiniPreamble(contextText, resolved, mode = "main") {
+  const intro = buildMiniIntro(resolved, mode);
+  const toolNote = resolved.mode === "plugin-managed" ? MINI_TOOL_NOTE : "";
+  const sessionContext = contextText.trim() ? `\n\n<session-context>\n${contextText}\n</session-context>` : "";
+  return `${intro}${toolNote}${sessionContext}`;
+}
+function buildMiniIntro(resolved, mode) {
+  if (resolved.mode !== "custom-agent") {
+    return mode === "fresh" ? MINI_FRESH_INSTRUCTION : MINI_SIDE_QUESTION_INSTRUCTION;
+  }
+  if (mode === "fresh") {
+    return `You are answering a quick side question about an ongoing coding session and you are running as the configured OpenCode agent "${resolved.agent}". Follow that agent's own instructions, role, tone, and constraints closely while answering this as a mini side question. No conversation context from the main session has been copied into this mini session.`;
+  }
+  return `You are answering a quick side question about an ongoing coding session and you are running as the configured OpenCode agent "${resolved.agent}". Follow that agent's own instructions, role, tone, and constraints closely while answering this as a mini side question. Below is the conversation context from the session.`;
+}
+export function buildSessionCreatePayload(resolved, base) {
+  return {
+    title: base.title,
+    location: {
+      directory: base.directory
+    },
+    ...(resolved.mode === "custom-agent" ? {
+      agent: resolved.agent
+    } : {}),
+    ...(base.model?.providerID && base.model?.id ? {
+      model: {
+        providerID: base.model.providerID,
+        id: base.model.id,
+        ...(base.model.variant ? {
+          variant: base.model.variant
+        } : {})
+      }
+    } : {})
+  };
+}
+export function formatMiniNotice(...notices) {
+  const filtered = notices.filter(n => typeof n === "string" && n.length > 0);
+  return filtered.length > 0 ? filtered.join(" ") : undefined;
+}
+export function buildMiniErrorDetail(options) {
+  return [`Diagnostics: path=${options.path}`, `session=${options.sessionID ?? "pending"}`, `mode=${options.resolvedAgent.mode}`, `agent=${options.resolvedAgent.mode === "custom-agent" ? options.resolvedAgent.agent : "(plugin-managed)"}`, `model=${formatResolvedModel(options.resolvedModel)}`].join(", ");
+}
+function buildMiniAgentNotices(config, mode) {
+  const notices = [];
+  if (mode.mode === "plugin-managed" && mode.missingAgent) {
+    notices.push(`Configured mini agent ${mode.missingAgent} was not found. Falling back to plugin-managed mini mode.`);
+  }
+  if (mode.mode === "plugin-managed" && mode.unavailableAgent) {
+    notices.push(`Could not verify configured mini agent ${mode.unavailableAgent} because the agent list is unavailable. Falling back to plugin-managed mini mode.`);
+  }
+  return notices;
+}

package/dist/components/ActionButton.js

@@ -0,0 +1,39 @@
+import { createComponent as _$createComponent } from "@opentui/solid";
+import { effect as _$effect } from "@opentui/solid";
+import { createTextNode as _$createTextNode } from "@opentui/solid";
+import { insertNode as _$insertNode } from "@opentui/solid";
+import { insert as _$insert } from "@opentui/solid";
+import { setProp as _$setProp } from "@opentui/solid";
+import { createElement as _$createElement } from "@opentui/solid";
+/** @jsxImportSource @opentui/solid */
+
+import { Show } from "solid-js";
+export function ActionButton(props) {
+  return (() => {
+    var _el$ = _$createElement("box"),
+      _el$2 = _$createElement("text"),
+      _el$3 = _$createElement("b");
+    _$insertNode(_el$, _el$2);
+    _$setProp(_el$, "flexDirection", "row");
+    _$setProp(_el$, "onMouseUp", () => {
+      if (!props.disabled) props.onPress();
+    });
+    _$insertNode(_el$2, _el$3);
+    _$insert(_el$3, () => props.label);
+    _$insert(_el$, _$createComponent(Show, {
+      get when() {
+        return props.keybind;
+      },
+      get children() {
+        var _el$4 = _$createElement("text"),
+          _el$5 = _$createTextNode(` `);
+        _$insertNode(_el$4, _el$5);
+        _$insert(_el$4, () => props.keybind, null);
+        _$effect(_$p => _$setProp(_el$4, "fg", props.context.theme.text.subdued, _$p));
+        return _el$4;
+      }
+    }), null);
+    _$effect(_$p => _$setProp(_el$2, "fg", props.disabled ? props.context.theme.text.subdued : props.context.theme.text.default, _$p));
+    return _el$;
+  })();
+}