@webpresso/plugin-grok 0.0.10

package/LICENSE

@@ -0,0 +1,104 @@
+Elastic License 2.0
+===================
+
+Copyright (c) 2026 Webpresso, Inc.
+
+Acceptance
+----------
+
+By using the software, you agree to all of the terms and conditions below.
+
+Copyright License
+-----------------
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+Limitations
+-----------
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key
+functionality in the software, and you may not remove or obscure any
+functionality in the software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software. Any use of the licensor's trademarks
+is subject to applicable law.
+
+Patents
+-------
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software.
+
+If you or your company make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license for the software
+granted under these terms ends immediately. If your company makes such a claim,
+your patent license ends immediately for work on behalf of your company.
+
+Notices
+-------
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+No Other Rights
+---------------
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+Termination
+-----------
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+No Liability
+------------
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+Definitions
+-----------
+
+The licensor is the entity offering these terms, and the software is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+you refers to the individual or entity agreeing to these terms.
+
+your company is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+control means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+your licenses are all the licenses granted to you for the software under these
+terms.
+
+use means anything you do with the software requiring one of your licenses.
+
+trademark means trademarks, service marks, and similar rights.

package/bin/wp

@@ -0,0 +1,54 @@
+#!/bin/sh
+# Resolve the Webpresso `wp` executable and hand this process over to it.
+#
+# `exec` rather than a spawn wrapper: the MCP server this shim launches is a
+# long-lived stdio service, and a wrapper process that merely relays for it is a
+# layer that can die while leaving the server behind, orphaned and holding the
+# client's pipe. After `exec` there is no shim process left to strand — the
+# launcher IS this pid, so the host's signals and pipe closure reach it directly.
+# It also makes every non-MCP command a byte-exact passthrough, including TTY
+# behavior that a relay would otherwise disturb.
+#
+# Arguments are forwarded verbatim through the quoted "$@" expansion. The plugin
+# manifest invokes this file as `bin/wp mcp`, so dropping or word-splitting
+# arguments would silently break the only real launch surface.
+
+set -u
+
+fail() {
+  printf '%s\n' "$1" >&2
+  exit 1
+}
+
+: "${WEBPRESSO_WP_BIN:=}"
+: "${WP_FORCE_JIT_PATH:=}"
+
+if [ -n "$WEBPRESSO_WP_BIN" ] && [ -n "$WP_FORCE_JIT_PATH" ]; then
+  fail "WEBPRESSO_WP_BIN and WP_FORCE_JIT_PATH are both set; unset one. Product path is the Webpresso app launcher (~/.webpresso/bin/wp) or monorepo JIT (WP_FORCE_JIT_PATH to a webpresso/app checkout). Do not dual-set overrides."
+fi
+
+if [ -n "$WEBPRESSO_WP_BIN" ]; then
+  target=$WEBPRESSO_WP_BIN
+  source_label=WEBPRESSO_WP_BIN
+elif [ -n "$WP_FORCE_JIT_PATH" ]; then
+  target=$WP_FORCE_JIT_PATH/bin/wp
+  source_label=WP_FORCE_JIT_PATH
+else
+  target=${HOME:-}/.webpresso/bin/wp
+  source_label="Webpresso app launcher"
+fi
+
+# Refuse to exec this shim again: a self-referential target would loop forever
+# instead of failing with a diagnostic.
+if [ "$target" = "$0" ]; then
+  fail "$source_label points to this shim ($target); set it to the Webpresso wp executable instead."
+fi
+
+if [ ! -f "$target" ] || [ ! -x "$target" ]; then
+  fail "$source_label points to $target, but that executable is not available. Set WEBPRESSO_WP_BIN to the Webpresso wp executable, set WP_FORCE_JIT_PATH to an agent-kit checkout, or install the Webpresso app."
+fi
+
+WP_SKIP_UPDATE_CHECK=${WP_SKIP_UPDATE_CHECK:-1}
+export WP_SKIP_UPDATE_CHECK
+
+exec "$target" "$@"

package/hooks/hooks.json

@@ -0,0 +1,81 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "wp_bin=; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -n \"${WP_FORCE_JIT_PATH:-}\" ]; then printf '%s\\n' 'WEBPRESSO_WP_BIN and WP_FORCE_JIT_PATH are both set; unset one.' >&2; exit 2; fi; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -x \"${WEBPRESSO_WP_BIN}\" ]; then wp_bin=\"${WEBPRESSO_WP_BIN}\"; elif [ -n \"${WP_FORCE_JIT_PATH:-}\" ] && [ -x \"${WP_FORCE_JIT_PATH}/bin/wp\" ]; then wp_bin=\"${WP_FORCE_JIT_PATH}/bin/wp\"; elif [ -x \"${HOME}/.webpresso/bin/wp\" ]; then wp_bin=\"${HOME}/.webpresso/bin/wp\"; fi; if [ -n \"$wp_bin\" ]; then env WP_HOOK_HOST='grok' \"$wp_bin\" hook sessionstart-routing; hook_status=$?; if [ \"$hook_status\" -eq 2 ]; then exit 2; elif [ \"$hook_status\" -ne 0 ]; then true; fi; else true; fi # wp-sessionstart-routing",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash|run_terminal_command|Write|write|Edit|search_replace|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "wp_bin=; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -n \"${WP_FORCE_JIT_PATH:-}\" ]; then printf '%s\\n' 'WEBPRESSO_WP_BIN and WP_FORCE_JIT_PATH are both set; unset one.' >&2; exit 2; fi; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -x \"${WEBPRESSO_WP_BIN}\" ]; then wp_bin=\"${WEBPRESSO_WP_BIN}\"; elif [ -n \"${WP_FORCE_JIT_PATH:-}\" ] && [ -x \"${WP_FORCE_JIT_PATH}/bin/wp\" ]; then wp_bin=\"${WP_FORCE_JIT_PATH}/bin/wp\"; elif [ -x \"${HOME}/.webpresso/bin/wp\" ]; then wp_bin=\"${HOME}/.webpresso/bin/wp\"; fi; if [ -n \"$wp_bin\" ]; then env WP_HOOK_HOST='grok' \"$wp_bin\" hook pretool-guard; hook_status=$?; if [ \"$hook_status\" -eq 2 ]; then exit 2; elif [ \"$hook_status\" -ne 0 ]; then printf '%s\\n' \"{\\\"decision\\\":\\\"deny\\\",\\\"reason\\\":\\\"GUARD_PRETOOL_FAILURE: pretool-guard exit $hook_status; run wp hooks doctor\\\",\\\"hookSpecificOutput\\\":{\\\"hookEventName\\\":\\\"PreToolUse\\\",\\\"permissionDecision\\\":\\\"deny\\\",\\\"permissionDecisionReason\\\":\\\"GUARD_PRETOOL_FAILURE: pretool-guard exit $hook_status; run wp hooks doctor\\\"}}\"; printf '%s\\n' \"GUARD_PRETOOL_FAILURE: pretool-guard exit $hook_status; run wp hooks doctor\" >&2; exit 2; fi; else printf '%s\\n' '{\"decision\":\"deny\",\"reason\":\"GUARD_PRETOOL_FAILURE: wp missing; set WEBPRESSO_WP_BIN or install the app\",\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"deny\",\"permissionDecisionReason\":\"GUARD_PRETOOL_FAILURE: wp missing; set WEBPRESSO_WP_BIN or install the app\"}}'; printf '%s\\n' 'GUARD_PRETOOL_FAILURE: wp missing; set WEBPRESSO_WP_BIN or install the app' >&2; exit 2; fi # wp-pretool-guard",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|write|Edit|search_replace|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "wp_bin=; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -n \"${WP_FORCE_JIT_PATH:-}\" ]; then printf '%s\\n' 'WEBPRESSO_WP_BIN and WP_FORCE_JIT_PATH are both set; unset one.' >&2; exit 2; fi; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -x \"${WEBPRESSO_WP_BIN}\" ]; then wp_bin=\"${WEBPRESSO_WP_BIN}\"; elif [ -n \"${WP_FORCE_JIT_PATH:-}\" ] && [ -x \"${WP_FORCE_JIT_PATH}/bin/wp\" ]; then wp_bin=\"${WP_FORCE_JIT_PATH}/bin/wp\"; elif [ -x \"${HOME}/.webpresso/bin/wp\" ]; then wp_bin=\"${HOME}/.webpresso/bin/wp\"; fi; if [ -n \"$wp_bin\" ]; then env WP_HOOK_HOST='grok' \"$wp_bin\" hook post-tool; hook_status=$?; if [ \"$hook_status\" -eq 2 ]; then exit 2; elif [ \"$hook_status\" -ne 0 ]; then true; fi; else true; fi # wp-post-tool",
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "wp_bin=; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -n \"${WP_FORCE_JIT_PATH:-}\" ]; then printf '%s\\n' 'WEBPRESSO_WP_BIN and WP_FORCE_JIT_PATH are both set; unset one.' >&2; exit 2; fi; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -x \"${WEBPRESSO_WP_BIN}\" ]; then wp_bin=\"${WEBPRESSO_WP_BIN}\"; elif [ -n \"${WP_FORCE_JIT_PATH:-}\" ] && [ -x \"${WP_FORCE_JIT_PATH}/bin/wp\" ]; then wp_bin=\"${WP_FORCE_JIT_PATH}/bin/wp\"; elif [ -x \"${HOME}/.webpresso/bin/wp\" ]; then wp_bin=\"${HOME}/.webpresso/bin/wp\"; fi; if [ -n \"$wp_bin\" ]; then env WP_HOOK_HOST='grok' \"$wp_bin\" hook guard-switch; hook_status=$?; if [ \"$hook_status\" -eq 2 ]; then exit 2; elif [ \"$hook_status\" -ne 0 ]; then true; fi; else true; fi # wp-guard-switch",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "wp_bin=; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -n \"${WP_FORCE_JIT_PATH:-}\" ]; then printf '%s\\n' 'WEBPRESSO_WP_BIN and WP_FORCE_JIT_PATH are both set; unset one.' >&2; exit 2; fi; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -x \"${WEBPRESSO_WP_BIN}\" ]; then wp_bin=\"${WEBPRESSO_WP_BIN}\"; elif [ -n \"${WP_FORCE_JIT_PATH:-}\" ] && [ -x \"${WP_FORCE_JIT_PATH}/bin/wp\" ]; then wp_bin=\"${WP_FORCE_JIT_PATH}/bin/wp\"; elif [ -x \"${HOME}/.webpresso/bin/wp\" ]; then wp_bin=\"${HOME}/.webpresso/bin/wp\"; fi; if [ -n \"$wp_bin\" ]; then env WP_HOOK_HOST='grok' \"$wp_bin\" hook stop-qa; hook_status=$?; if [ \"$hook_status\" -eq 2 ]; then exit 2; elif [ \"$hook_status\" -ne 0 ]; then printf '%s\\n' '{}'; fi; else printf '%s\\n' '{}'; fi # wp-stop-qa",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "wp_bin=; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -n \"${WP_FORCE_JIT_PATH:-}\" ]; then printf '%s\\n' 'WEBPRESSO_WP_BIN and WP_FORCE_JIT_PATH are both set; unset one.' >&2; exit 2; fi; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -x \"${WEBPRESSO_WP_BIN}\" ]; then wp_bin=\"${WEBPRESSO_WP_BIN}\"; elif [ -n \"${WP_FORCE_JIT_PATH:-}\" ] && [ -x \"${WP_FORCE_JIT_PATH}/bin/wp\" ]; then wp_bin=\"${WP_FORCE_JIT_PATH}/bin/wp\"; elif [ -x \"${HOME}/.webpresso/bin/wp\" ]; then wp_bin=\"${HOME}/.webpresso/bin/wp\"; fi; if [ -n \"$wp_bin\" ]; then env WP_HOOK_HOST='grok' \"$wp_bin\" hook stop-ultragoal; hook_status=$?; if [ \"$hook_status\" -eq 2 ]; then exit 2; elif [ \"$hook_status\" -ne 0 ]; then printf '%s\\n' '{}'; fi; else printf '%s\\n' '{}'; fi # wp-stop-ultragoal",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "wp_bin=; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -n \"${WP_FORCE_JIT_PATH:-}\" ]; then printf '%s\\n' 'WEBPRESSO_WP_BIN and WP_FORCE_JIT_PATH are both set; unset one.' >&2; exit 2; fi; if [ -n \"${WEBPRESSO_WP_BIN:-}\" ] && [ -x \"${WEBPRESSO_WP_BIN}\" ]; then wp_bin=\"${WEBPRESSO_WP_BIN}\"; elif [ -n \"${WP_FORCE_JIT_PATH:-}\" ] && [ -x \"${WP_FORCE_JIT_PATH}/bin/wp\" ]; then wp_bin=\"${WP_FORCE_JIT_PATH}/bin/wp\"; elif [ -x \"${HOME}/.webpresso/bin/wp\" ]; then wp_bin=\"${HOME}/.webpresso/bin/wp\"; fi; if [ -n \"$wp_bin\" ]; then env WP_HOOK_HOST='grok' \"$wp_bin\" hook precompact-snapshot; hook_status=$?; if [ \"$hook_status\" -eq 2 ]; then exit 2; elif [ \"$hook_status\" -ne 0 ]; then printf '%s\\n' '{}'; fi; else printf '%s\\n' '{}'; fi # wp-precompact-snapshot",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@webpresso/plugin-grok",
+  "version": "0.0.10",
+  "private": false,
+  "description": "Grok Build plugin adapter for Webpresso agent-kit skills, hooks, and MCP runtime.",
+  "homepage": "https://github.com/webpresso/app#readme",
+  "bugs": {
+    "url": "https://github.com/webpresso/app/issues"
+  },
+  "license": "Elastic-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/webpresso/app.git",
+    "directory": "packages/plugin-grok"
+  },
+  "files": [
+    "plugin.json",
+    "hooks",
+    "bin/wp",
+    "LICENSE",
+    "!README.md",
+    "!CHANGELOG.md",
+    "!**/*.test.js",
+    "!**/*.test.ts"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}

package/plugin.json

@@ -0,0 +1,14 @@
+{
+  "name": "agent-kit",
+  "version": "0.0.10",
+  "description": "Webpresso agent-kit: blueprints, skills, hooks, and MCP server",
+  "author": {
+    "name": "Webpresso",
+    "url": "https://github.com/webpresso"
+  },
+  "homepage": "https://github.com/webpresso/agent-kit#readme",
+  "repository": "https://github.com/webpresso/agent-kit",
+  "license": "Elastic-2.0",
+  "keywords": ["agent", "blueprint", "mcp", "skills", "developer-tools", "grok"],
+  "hooks": "./hooks/hooks.json"
+}