@joe-broadhead/opencode-granola 0.0.0 → 0.0.2

package/dist/tui.js

@@ -4,18 +4,26 @@ import { createSignal } from "solid-js";
 
 // src/rpc/contract.ts
 import { Rpc } from "@opencode/plugin/rpc";
+var STATES = ["connected", "sign_in_required", "connecting", "disabled", "failed", "not_configured", "conflict"];
 var STATUS_SCHEMA = {
   type: "object",
   additionalProperties: false,
-  required: ["state", "tools", "unguardedAgents", "exportDirectory", "pluginVersion", "hostVersion", "next"],
+  required: ["version", "host", "state", "tools", "unguardedAgents", "exportDirectory", "nextStep"],
   properties: {
-    state: { type: "string", enum: ["connected", "pending", "disabled", "failed", "needs_auth", "absent"] },
+    version: { type: "string" },
+    host: {
+      type: "object",
+      additionalProperties: false,
+      required: ["version", "range", "tested"],
+      properties: { version: { type: ["string", "null"] }, range: { type: "string" }, tested: { type: "boolean" } }
+    },
+    state: { type: "string", enum: STATES },
     title: { type: "string" },
     problem: {
       type: "object",
       additionalProperties: false,
-      required: ["code", "message", "next"],
-      properties: { code: { type: "string" }, message: { type: "string" }, next: { type: "string" } }
+      required: ["code", "message"],
+      properties: { code: { type: "string" }, message: { type: "string" } }
     },
     conflict: { type: "string" },
     tools: {
@@ -45,31 +53,43 @@ var STATUS_SCHEMA = {
       }
     },
     exportDirectory: { type: "string" },
-    pluginVersion: { type: "string" },
-    hostVersion: { type: "string" },
     hostWarning: { type: "string" },
-    next: { type: "string" }
+    nextStep: { type: "string" }
   }
 };
+var STATUS_ERROR_SCHEMA = {
+  type: "object",
+  additionalProperties: false,
+  required: ["code", "next"],
+  properties: { code: { type: "string" }, next: { type: "string" } }
+};
 var STATE_LABELS = {
   connected: "connected",
-  pending: "connecting",
-  needs_auth: "sign-in required",
+  connecting: "connecting",
+  sign_in_required: "sign-in required",
   failed: "failed",
   disabled: "disabled",
-  absent: "not configured"
+  not_configured: "not configured",
+  conflict: "conflict"
 };
 var TONES = {
   connected: "ok",
-  pending: "info",
-  needs_auth: "warning",
+  connecting: "info",
+  sign_in_required: "warning",
   failed: "error",
   disabled: "info",
-  absent: "warning"
+  not_configured: "warning",
+  conflict: "warning"
 };
+function hostRow(status) {
+  const { version, range, tested } = status.host;
+  const found = version ?? "unknown";
+  if (status.hostWarning) return { label: "OpenCode", text: `${found} (host untested: ${status.hostWarning}), plugin ${status.version}`, tone: "warning" };
+  return { label: "OpenCode", text: `${found} (${tested ? "tested" : "untested"}; supported range ${range}), plugin ${status.version}`, ...tested ? {} : { tone: "info" } };
+}
 function statusRows(status) {
   const connected = status.state === "connected";
-  const connection = status.conflict ? `conflict: ${status.conflict}` : `${STATE_LABELS[status.state]}${status.title ? ` (${status.title})` : ""}${status.problem ? `: ${status.problem.message} (${status.problem.code})` : ""}`;
+  const connection = status.state === "conflict" && status.conflict ? `conflict: ${status.conflict}` : `${STATE_LABELS[status.state]}${status.title ? ` (${status.title})` : ""}${status.problem ? `: ${status.problem.message} (${status.problem.code})` : ""}`;
   const tools = [`${status.tools.visible} available`];
   if (status.tools.hidden) tools.push(`${status.tools.hidden} hidden`);
   if (status.tools.unknown) {
@@ -78,18 +98,18 @@ function statusRows(status) {
   }
   const agents = status.unguardedAgents;
   return [
-    { label: "Connection", text: connection, tone: status.conflict ? "warning" : TONES[status.state] },
+    { label: "Connection", text: connection, tone: TONES[status.state] },
     { label: "Account", text: !connected ? "unknown until Granola connects" : status.workspace ? `workspace ${status.workspace}` : "workspace unknown until the agent reads your Granola account" },
     { label: "Access", text: "reads run without asking; changes, new tools and exports ask first" },
     { label: "Export folder", text: status.exportDirectory },
     { label: "Tools", text: connected ? tools.join(", ") : "none until Granola connects" },
-    ...agents.length ? [{
+    agents.length ? {
       label: "Agents without default rules",
-      text: `${agents.join(", ")}: Granola writes run there without asking`,
+      text: `${agents.join(", ")}: Granola changes and new tools may run there without asking`,
       tone: "warning",
       block: permissionsSnippet(agents, status.permissionsBlock ?? [])
-    }] : [],
-    status.hostWarning ? { label: "OpenCode", text: `${status.hostVersion} (host untested: ${status.hostWarning}), plugin ${status.pluginVersion}`, tone: "warning" } : { label: "OpenCode", text: `${status.hostVersion} (tested), plugin ${status.pluginVersion}` }
+    } : { label: "Agents without default rules", text: "none" },
+    hostRow(status)
   ];
 }
 function permissionsSnippet(agents, block) {
@@ -111,7 +131,8 @@ var Granola = Rpc.define({
   methods: {
     status: {
       input: { type: "object", properties: {}, additionalProperties: false },
-      output: STATUS_SCHEMA
+      output: STATUS_SCHEMA,
+      errors: { unavailable: STATUS_ERROR_SCHEMA }
     }
   },
   events: {}
@@ -127,10 +148,10 @@ function view(details) {
   if (details.type === "unavailable") {
     return {
       rows: [{ label: "Connection", text: `unknown: ${details.reason}`, tone: "warning" }],
-      next: "Check that granola.meetings is active in /plugins, then press r to refresh."
+      next: details.next ?? "Check that granola.meetings is active in /plugins, then press r to refresh."
     };
   }
-  return { rows: statusRows(details.status), next: details.status.next };
+  return { rows: statusRows(details.status), next: details.status.nextStep };
 }
 
 // src/tui/view.tsx
@@ -275,9 +296,17 @@ function StatusDialog(props) {
 }
 
 // src/tui/index.tsx
-function reason(error) {
+function failure(error) {
   const type = typeof error === "object" && error !== null && "type" in error ? error.type : void 0;
-  return type === "rpc.unavailable" || type === "rpc.method_not_found" ? "the Granola plugin is not running on this OpenCode server" : "the status request failed";
+  if (type === "unavailable") return {
+    type: "unavailable",
+    reason: "Granola status could not be read (STATUS_UNAVAILABLE)",
+    next: "Press r to refresh in a few seconds."
+  };
+  return {
+    type: "unavailable",
+    reason: type === "rpc.unavailable" || type === "rpc.method_not_found" ? "the Granola plugin is not running on this OpenCode server" : "the status request failed"
+  };
 }
 var plugin = {
   id: "granola.meetings.tui",
@@ -297,10 +326,7 @@ var plugin = {
       } : {}).then((status) => ({
         type: "ready",
         status
-      }), (error) => ({
-        type: "unavailable",
-        reason: reason(error)
-      })).then((next) => {
+      }), failure).then((next) => {
         if (request === generation) setDetails(next);
       });
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joe-broadhead/opencode-granola",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "description": "Unofficial OpenCode plugin for Granola meeting notes, through Granola's official MCP server",
   "keywords": [
     "opencode",

package/skills/granola/SKILL.md

@@ -22,7 +22,7 @@ For a brief before a meeting, or a catch-up on a person, company or topic, also
 - `search_meetings`: by keyword, participant or company, and date. Keywords match titles, summaries and the user's notes, not transcripts, so an empty result does not mean that a topic was never discussed.
 - `list_meetings`: meetings in a date range, newest first (the last 7 days by default), optionally in one folder.
 - `search_transcripts`: by keyword in what was said; it returns matching transcript passages. Not every Granola plan includes transcripts.
-- `list_meeting_folders`: folders and their IDs, for the folder filter of both tools above.
+- `list_meeting_folders`: folders and their IDs, for the `folder_id` filter of `search_meetings` and `list_meetings`.
 - Results come in pages. While a response offers a next cursor, continue with it and the same filters before you say that a meeting does not exist.
 
 ## Read meetings
@@ -60,6 +60,10 @@ Reads run without a prompt. OpenCode asks the user before each of these, unless
 
 Make a change only when the user asked for it, and say first what it will do. A folder with workspace visibility shares every note in it with the whole workspace. If the user declines or the permission is denied, do not retry or find another way. In `opencode run` with nobody present to answer, these calls are denied unless the user's OpenCode permissions allow them. If `/granola-status` warns that an agent did not get Granola's permission defaults, pass the warning and its fix to the user.
 
+## Scripts
+
+When the user wants a job that runs without you, such as a cron job or a shell script, it can call Granola's read tools through the OpenCode server, with no model. The RPC `granola.meetings.tools` has one method per read, such as `list_meetings`, `get_meetings` and `get_meeting_transcript`, with the tools' own input, and `describe`, which lists them with their input schemas. Each call is `opencode api post /api/rpc/granola.meetings.tools/<method>` with the body `{"input":{"sessionID":"<session>","input":<the tool's input>}}`. The script runs as that session's agent, under its permission rules, so have the script create its session once with `opencode api post /api/session` and a body such as `{"title":"weekly meetings","agent":"build"}`. An ask is refused, so the agent needs the reads allowed; the default rules allow them. Scripts cannot make changes, sign out or export files. The details are in the plugin's `docs/scripting.md`.
+
 ## Save meetings as Markdown
 
 `export_markdown` writes the notes, the transcript, or both, for 1 to 20 meetings into one Markdown file in the user's export folder; `/granola-status` shows the folder. The content goes straight to the file without passing through the conversation, so prefer it to reading a long transcript just to save it.