@joe-broadhead/opencode-gws 0.0.2 → 0.0.4

package/dist/tui.js

@@ -19,6 +19,7 @@ var object = (properties, required) => ({ type: "object", properties, required }
 var MODES = ["interactive", "credentials_file", "access_token"];
 var ACCESS = ["read", "write"];
 var CLIENT_SOURCES = ["account", "plugin", "pasted"];
+var STATES = ["connected", "sign_in_required", "not_configured", "host_untested"];
 var account = object(
   {
     alias: text,
@@ -38,9 +39,9 @@ var account = object(
 );
 var status = object(
   {
-    pluginVersion: text,
-    hostVersion: text,
-    hostWarning: text,
+    version: text,
+    host: object({ version: { type: ["string", "null"] }, range: text, tested: { type: "boolean" } }, ["version", "range", "tested"]),
+    state: { enum: STATES },
     gws: object({ path: text, version: text }, ["path", "version"]),
     services: texts,
     accounts: { type: "array", items: account },
@@ -49,7 +50,7 @@ var status = object(
     permissionsBlock: text,
     nextStep: text
   },
-  ["pluginVersion", "hostVersion", "gws", "services", "accounts", "unguardedAgents"]
+  ["version", "host", "state", "gws", "services", "accounts", "unguardedAgents", "nextStep"]
 );
 var Gws = Rpc.define({
   id: RPC_ID,
@@ -69,15 +70,15 @@ function isAccount(value) {
   return isRecord(value) && isText(value["alias"]) && MODES.includes(value["mode"]) && isStrings(value["services"]) && typeof value["connected"] === "boolean" && optional(value["integrationID"], isText) && optional(value["needsAuth"], (entry) => entry === true) && optional(value["access"], (entry) => ACCESS.includes(entry)) && optional(value["clientSource"], (entry) => CLIENT_SOURCES.includes(entry)) && optional(value["grantedScopes"], isStrings) && optional(value["missingScopes"], isStrings) && optional(value["delegationRequired"], isStrings) && optional(value["nextStep"], isText);
 }
 function isStatus(value) {
-  return isRecord(value) && isText(value["pluginVersion"]) && isText(value["hostVersion"]) && optional(value["hostWarning"], isText) && isRecord(value["gws"]) && isText(value["gws"]["path"]) && isText(value["gws"]["version"]) && isStrings(value["services"]) && Array.isArray(value["accounts"]) && value["accounts"].every(isAccount) && optional(value["auditDegraded"], (entry) => typeof entry === "boolean") && isStrings(value["unguardedAgents"]) && optional(value["permissionsBlock"], isText) && optional(value["nextStep"], isText);
+  return isRecord(value) && isText(value["version"]) && isRecord(value["host"]) && (value["host"]["version"] === null || isText(value["host"]["version"])) && isText(value["host"]["range"]) && typeof value["host"]["tested"] === "boolean" && STATES.includes(value["state"]) && isRecord(value["gws"]) && isText(value["gws"]["path"]) && isText(value["gws"]["version"]) && isStrings(value["services"]) && Array.isArray(value["accounts"]) && value["accounts"].every(isAccount) && optional(value["auditDegraded"], (entry) => typeof entry === "boolean") && isStrings(value["unguardedAgents"]) && optional(value["permissionsBlock"], isText) && isText(value["nextStep"]);
 }
-var NOTHING_TO_DO = "Nothing to do.";
 function connectionLabel(account2) {
   if (account2.connected) return "connected";
   return account2.mode === "interactive" ? "sign-in required" : "not configured";
 }
 function openCodeLabel(status2) {
-  return status2.hostWarning ? `${status2.hostVersion} (host untested: ${status2.hostWarning})` : `${status2.hostVersion} (tested)`;
+  const version = status2.host.version ?? "unknown";
+  return status2.host.tested ? `${version} (tested)` : `${version} (host untested; supported range ${status2.host.range})`;
 }
 var DELEGATION_LABEL = "Needs domain-wide delegation";
 function delegationText(account2) {
@@ -397,7 +398,7 @@ function StatusBody(props) {
         return openCodeLabel(props.status);
       },
       get fg() {
-        return tone(props.status.hostWarning ? "warning" : "success");
+        return tone(props.status.host.tested ? "success" : "warning");
       },
       get muted() {
         return muted();
@@ -406,7 +407,7 @@ function StatusBody(props) {
     _$insert(_el$6, _$createComponent(Row, {
       label: "Next step",
       get value() {
-        return props.status.nextStep ?? NOTHING_TO_DO;
+        return props.status.nextStep;
       },
       get fg() {
         return base();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joe-broadhead/opencode-gws",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Unofficial OpenCode plugin for Google Workspace (gws CLI)",
   "type": "module",
   "license": "MIT",
@@ -26,9 +26,11 @@
   },
   "files": [
     "dist",
+    "assets/icon.svg",
     "skills",
     "manifest/generated.json",
-    "views",
+    "views/gmail-thread.html",
+    "views/jelly-view.js",
     "README.md",
     "LICENSE",
     "NOTICE",
@@ -50,10 +52,10 @@
     "docs:coverage": "node scripts/generate-docs.mjs"
   },
   "optionalDependencies": {
-    "@joe-broadhead/opencode-gws-bin-darwin-arm64": "0.0.2",
-    "@joe-broadhead/opencode-gws-bin-darwin-x64": "0.0.2",
-    "@joe-broadhead/opencode-gws-bin-linux-arm64-gnu": "0.0.2",
-    "@joe-broadhead/opencode-gws-bin-linux-x64-gnu": "0.0.2"
+    "@joe-broadhead/opencode-gws-bin-darwin-arm64": "0.0.4",
+    "@joe-broadhead/opencode-gws-bin-darwin-x64": "0.0.4",
+    "@joe-broadhead/opencode-gws-bin-linux-arm64-gnu": "0.0.4",
+    "@joe-broadhead/opencode-gws-bin-linux-x64-gnu": "0.0.4"
   },
   "devDependencies": {
     "@babel/core": "7.29.7",
@@ -75,6 +77,8 @@
   },
   "jelly": {
     "title": "Google Workspace",
+    "summary": "Gmail, Calendar, Drive, Docs and Sheets.",
+    "icon": "assets/icon.svg",
     "tools": [
       {
         "name": "gws.status",
@@ -168,7 +172,11 @@
       {
         "id": "google",
         "label": "Google Workspace",
-        "integration": "gws-*"
+        "integration": "gws-*",
+        "relay": {
+          "redirectField": "redirectUri",
+          "portField": "callbackPort"
+        }
       }
     ],
     "contributes": {

package/skills/opencode-gws/SKILL.md

@@ -47,7 +47,7 @@ A change is two calls.
 | export | `gws_export` |
 | admin | `gws_admin` |
 
-The plan's category wins over the manifest. A Drive update whose body sets `trashed` to true is a delete: commit with `gws_delete`. A Calendar event write whose `sendUpdates` is `all` or `externalOnly` is a send: commit with `gws_send`. A read with `download.path` is an export: commit with `gws_export`.
+The plan's category wins over the manifest. A Drive update whose body sets `trashed` to true is a delete: commit with `gws_delete`. A Calendar event write whose `sendUpdates` is not `none`, or whose `sendNotifications` is true, emails the guests and is a send: commit with `gws_send`. A read with `download.path` is an export: commit with `gws_export`.
 
 Plans are single-use and bound to this session, agent, and account. `PLAN_EXPIRED`, `PLAN_ALREADY_USED`, and `PLAN_CALLER_MISMATCH` mean: read the current state, plan again, and show the new preview. `CATEGORY_MISMATCH` means you called the wrong commit tool.
 
@@ -120,6 +120,8 @@ An error is `CODE: What happened. Next step: What to do.` Do the next step once.
 | `OPERATION_UNKNOWN` | The id is not in the catalog. Search again with `gws_catalog`. |
 | `HELPER_UNSUPPORTED` | The helper cannot run. Use the method `gws_catalog` names as `alternative`. |
 | `POLICY_DENIED` | Stop. Tell the user. Do not rephrase the call to get around the deny. |
+| `RECIPIENTS_UNKNOWN` | A recipient rule applies and the plugin could not tell who the send or share reaches. Name the recipients in `to`, `cc` and `bcc` (or the `To`, `Cc` and `Bcc` headers of `raw`) once; otherwise tell the user. |
+| `ACCOUNT_DOMAIN_UNKNOWN` | A rule refuses external recipients and the account's own domain is unknown. Tell the user the message's next step. |
 | `GWS_VALIDATION_ERROR` | Fix the request. `gws_schema` shows the parameters. List and search need `fields`. |
 | `CANCELLED` | Do not retry unless the user asks. A commit that was already running may have been applied. Check with `gws_read` before planning again. |
 | `SESSION_UNKNOWN` | A script named a session that does not exist. Have it create a session and keep that id. |

package/skills/opencode-gws-recipes/SKILL.md

@@ -83,6 +83,8 @@ Reply. Same commit tool, `gws_send`:
 }
 ```
 
+The preview lists who the reply reaches: the sender, and for `gmail.reply-all` everyone else on the message. `to`, `cc` and `bcc` add recipients; `remove` leaves people out of a reply-all. `gmail.forward` takes `to`, `cc`, `bcc`, `body`, `attachments` and `noOriginalAttachments`. `gws_schema` lists every helper flag.
+
 ## Drive
 
 Recent files, read:
@@ -169,7 +171,7 @@ Create an event that does not email anyone. Plan category is write. Commit with
 }
 ```
 
-Create or move an event that emails attendees (`sendUpdates` of `all` or `externalOnly`). The plan category is **send**. Commit with `gws_send`.
+Create or move an event that emails attendees (`sendUpdates` of `all` or `externalOnly`; prefer it to the deprecated `sendNotifications`, which counts as a send too). The plan category is **send**. Commit with `gws_send`.
 
 ```json
 {

package/views/jelly-view.d.ts

@@ -1,73 +0,0 @@
-/**
- * The types of `jelly-view.js`, for a page written or checked with TypeScript:
- * `/// <reference path="./jelly-view.d.ts" />`. They mirror the bridge envelopes
- * in Jelly's contracts (`protocol/contracts/src/view-bridge.ts`); the page itself
- * carries only the JavaScript.
- */
-
-type JellyViewPlace = "tool-result" | "home-widget" | "settings-section";
-type JellyViewGrant = "data" | "state" | "rpc" | "open-agent";
-
-/** The fixed theme token set; the helper sets each as `--jelly-<name>` on the page. */
-interface JellyViewTheme {
-  text: string;
-  muted: string;
-  surface: string;
-  raised: string;
-  border: string;
-  accent: string;
-  "on-accent": string;
-  danger: string;
-  font: string;
-  radius: string;
-  scheme: "light" | "dark";
-}
-
-interface JellyViewHello {
-  v: 1;
-  kind: "hello";
-  /** `package` is null for a Home app an agent made. */
-  view: { package: string | null; id: string; title: string; place: JellyViewPlace };
-  grants: JellyViewGrant[];
-  /** The methods `call` may name. */
-  rpc: string[];
-  theme: JellyViewTheme;
-}
-
-/** A view's state: JSON of at most 64 KB, and the revision a write must name. */
-interface JellyViewState {
-  revision: number;
-  data: unknown;
-}
-
-type JellyViewPush =
-  | { v: 1; kind: "data.changed"; data: unknown }
-  | ({ v: 1; kind: "state.changed" } & JellyViewState)
-  | { v: 1; kind: "theme.changed"; theme: JellyViewTheme }
-  | { v: 1; kind: "visibility"; visible: boolean }
-  /** The call with request id `re` waits for the person, at most until `until` (ISO time). */
-  | { v: 1; kind: "rpc.waiting"; re: string; until: string };
-
-interface JellyView {
-  hello: JellyViewHello;
-  /** Hear pushes; returns the way to stop. */
-  on(listener: (push: JellyViewPush) => void): () => void;
-  /** Any request by its op, for one the helper has no name for. */
-  request(op: string, fields?: Record<string, unknown>): Promise<unknown>;
-  /** The place's data (the `data` grant). */
-  data(): Promise<unknown>;
-  /** The view's state (the `state` grant). */
-  state(): Promise<JellyViewState>;
-  /** Replace the state if `revision` is still the stored one; rejects on a conflict. */
-  setState(revision: number, data: unknown): Promise<JellyViewState>;
-  /** One of the methods the hello lists (the `rpc` grant). */
-  call(method: string, input?: unknown): Promise<unknown>;
-  /** Start a message for the person to send; it is never sent (the `open-agent` grant). */
-  openAgent(prefill?: string): Promise<null>;
-  /** The height the page needs, in CSS pixels, up to 1200: a hint the app may draw shorter. */
-  resize(height: number): Promise<null>;
-  /** Not mine: the app closes the frame and keeps its ordinary look. */
-  decline(): Promise<null>;
-}
-
-declare function jellyView(): Promise<JellyView>;