@0xmaxma/claude-gateway 1.5.2 → 1.5.3

package/mcp/tools/apps/module.ts

@@ -52,8 +52,8 @@ export class AppsModule implements ToolModule {
           properties: {
             registry_app: { type: 'string', description: 'Registry app name (e.g. "getpod-manager")' },
             version: { type: 'string', description: 'Registry version to install (default: latest)' },
-            github_url: { type: 'string', description: 'GitHub repo URL (requires commit)' },
-            commit: { type: 'string', description: '40-char hex commit hash (required with github_url)' },
+            github_url: { type: 'string', description: 'GitHub repo URL' },
+            commit: { type: 'string', description: '40-char hex commit hash to pin (optional; with github_url, omit to auto-resolve the default branch HEAD)' },
             local_path: { type: 'string', description: 'Local app path within ~/.claude-gateway/apps/' },
             env_vars: {
               type: 'object',

package/mcp/tools/apps/skills/install-app/SKILL.md

@@ -18,7 +18,8 @@ Arguments passed: `$ARGUMENTS`
 
 - `/install-app <registry-name>` — install latest version from registry
 - `/install-app <registry-name> <version>` — install specific version
-- `/install-app <github-url> <40-hex-commit>` — custom GitHub install (pinned commit)
+- `/install-app <github-url>` — custom GitHub install (installs the latest commit on the default branch)
+- `/install-app <github-url> <40-hex-commit>` — custom GitHub install pinned to a specific commit
 
 ---
 
@@ -30,8 +31,12 @@ Show the user:
 - Repo URL
 - Version you will install (and whether it is latest)
 
-**GitHub install:** validate that the commit is a 40-char hex string. If not, tell the user
-and stop.
+**GitHub install:** the commit is **optional**.
+- If the user supplied a commit, validate it is a 40-char hex string; if it is malformed,
+  tell the user and stop.
+- If **no commit** was given, do **not** ask the user to find one — call `install_app` with
+  just the `github_url` and the installer resolves the default branch's latest commit (HEAD)
+  automatically and pins it. Report the resolved commit in Step 5.
 
 If the app is not found in the registry and no GitHub URL given, stop with a helpful message.
 
@@ -66,7 +71,7 @@ Before installing, show a brief summary:
 Installing: <app-name> v<version>
 Source: <registry|github>
 Repo: <url>
-Commit: <first 8 chars>
+Commit: <first 8 chars, or "latest on default branch (auto-resolved)" for a GitHub install with no pinned commit>
 Proxy routes: (from registry metadata if available)
 Secrets to inject: <list or "none">
 
@@ -90,13 +95,17 @@ Store the returned `jobId`.
 Poll `poll_install_job` every 3 seconds. Show a brief progress line after each poll
 (use the last log entry from the job). Stop when status is `completed` or `failed`.
 
-On **completed**: show proxy URLs from `result.proxyUrls`.
+On **completed**: show proxy URLs from `result.proxyUrls`. For a GitHub install with no
+pinned commit, also report the commit that was resolved and installed (the job logs a
+`Resolved HEAD → <short>` line) so the user knows exactly what was pinned.
 On **failed**: show the error message and last 5 log entries.
 
 ---
 
 ## Notes
 
-- Never pass branch names as `commit` — only 40-char hex strings are valid.
+- The `commit` is optional for GitHub installs; when omitted the installer pins the latest
+  commit on the default branch. When a commit **is** supplied it must be a 40-char hex string
+  — never pass a branch name as `commit`.
 - `env_vars` values should not be echoed back to the user after collection.
 - If the user cancels at any confirmation step, say so and stop.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xmaxma/claude-gateway",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "Multi-agent gateway for Claude",
   "repository": {
     "type": "git",