@ycodium-ai/agent-grok 0.2.2014

package/README.md

@@ -0,0 +1,44 @@
+# @ycodium-ai/agent-grok
+
+Grok executor plugin. Spawns `grok agent stdio` over stdio and runs
+`ycodium-acp-executor` against `ycodium-acp-protocol`, with the Grok-specific
+semantics that used to live in the host Grok adapter:
+
+- `_x.ai/ask_user_question` (and its `x.ai/ask_user_question` alias) is surfaced as
+  structured user input (`user-input.*`), possibly several questions in one batch.
+  Answers are keyed by question text, option ids translate back to labels.
+- Prompt settlement: Grok 1.0.24+ stops answering the `session/prompt` RPC after
+  sending the private `_x.ai/session/prompt_complete` notification, so the turn
+  closes from that notification. A `stopReason: "error"` notification (quota
+  exhaustion sends exactly this) goes through the failure channel — never a blank
+  successful reply. On 1.0.30 a failed turn was observed sending the notification
+  and then still answering the RPC with a JSON-RPC error carrying the same
+  detail; the success path on 1.0.30 could not be observed in that environment.
+- Context-window usage comes from the prompt response `_meta` (`totalTokens`),
+  matched against the model catalog advertised in `initialize`'s
+  `_meta.modelState` for the window size.
+- Reasoning effort is a spawn argument: the user's selected tier is read from the
+  model selection before spawn and inserted as `grok agent --reasoning-effort
+<tier> stdio` (the flag must precede `stdio`; `session/set_mode` is silently
+  inert for it).
+- Sign-in is the RFC 8628 device-code flow: `grok login --device-auth` prints the
+  verification URL and user code itself and polls until approved.
+
+Facts:
+
+- `driverKind` is `grok`. Existing envelopes are `driver: "grok"` (no ACP
+  claiming); disk format is unchanged.
+- Account directory: only `GROK_HOME` is injected, never `HOME` (overriding
+  `HOME` would move macOS keychain lookup). An explicit `GROK_HOME` in the
+  instance environment table wins over the account-directory setting, and
+  credential reads use the home the subprocess actually sees. An empty
+  account directory means the CLI default `~/.grok` is used without injection.
+- Manifest permission is `{ kind: "executor" }`.
+- Session model switching is `unsupported` on the card until the plugin execution
+  path is wired to the model-management UI.
+
+Develop with `vp run --filter @ycodium-ai/agent-grok typecheck`, `build`, and `test`.
+
+## License
+
+UNLICENSED.

package/assets/icon.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none">
+  <style>
+    path { fill: #0F0F0F; }
+    @media (prefers-color-scheme: dark) { path { fill: #F5F5F5; } }
+  </style>
+  <path d="M9.26905 15.284L17.2479 9.36086C17.6391 9.07047 18.1981 9.18374 18.3845 9.63478C19.3655 12.0135 18.9272 14.8721 16.9755 16.8349C15.0238 18.7976 12.3082 19.228 9.8261 18.2477L7.1146 19.5102C11.0037 22.1834 15.7263 21.5223 18.6774 18.5525C21.0182 16.1985 21.7432 12.9897 21.0653 10.0961L21.0714 10.1023C20.0884 5.85143 21.3131 4.15233 23.8218 0.677913C23.8812 0.595532 23.9406 0.513151 24 0.428711L20.6987 3.74866V3.73836L9.267 15.2861" />
+  <path d="M7.62249 16.7237C4.83113 14.0422 5.3124 9.89222 7.69417 7.49905C9.45541 5.72786 12.341 5.00497 14.86 6.06768L17.5653 4.81138C17.0779 4.45714 16.4533 4.07613 15.7365 3.80839C12.4966 2.46764 8.6178 3.13492 5.98413 5.78141C3.45081 8.32904 2.65415 12.2463 4.02219 15.5889C5.04412 18.0871 3.36889 19.8541 1.68137 21.6377C1.08337 22.2699 0.483318 22.9022 0 23.5716L7.62045 16.7257" />
+</svg>