Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -579,7 +579,11 @@ jobs:
permissions:
id-token: write
contents: read
runs-on: ubuntu-latest
# Pinned: ubuntu-latest rolled to Ubuntu 26.04 on 2026-11-04, where this job's
# nginx apt-key import fails before any test runs (gpg 2.4.8 aborts with
# "/home/runner/.gnupg: directory does not exist"). Re-validate on 26.04
# before unpinning.
runs-on: ubuntu-24.04
strategy:
matrix:
registry:
Expand Down Expand Up @@ -1866,7 +1870,10 @@ jobs:
name: ${{ matrix.job_name }}
needs:
- dockerbuild
runs-on: ${{ matrix.platform == 'linux/arm64' && 'ubuntu-24.04-arm' || 'ubuntu-latest' }}
# Pinned: ubuntu-latest rolled to Ubuntu 26.04 on 2026-11-04; its newer Docker
# Compose writes container progress lines into the output the robot tests
# capture, failing 33 exact-output assertions. Re-validate on 26.04 before unpinning.
runs-on: ${{ matrix.platform == 'linux/arm64' && 'ubuntu-24.04-arm' || 'ubuntu-24.04' }}
timeout-minutes: ${{ vars.DEFAULT_JOB_TIMEOUT_MIN == '' && 120 || vars.DEFAULT_JOB_TIMEOUT_MIN }}
strategy:
fail-fast: false
Expand Down Expand Up @@ -2185,7 +2192,8 @@ jobs:
name: Docker Test Shard Verification
needs:
- dockertest
runs-on: ubuntu-latest
# Pinned with dockertest (see the note there).
runs-on: ubuntu-24.04
timeout-minutes: ${{ vars.DEFAULT_SHORT_JOB_TIMEOUT_MIN == '' && 15 || vars.DEFAULT_SHORT_JOB_TIMEOUT_MIN }}
steps:

Expand Down
57 changes: 0 additions & 57 deletions .github/workflows/openai-plugin.yml

This file was deleted.

113 changes: 113 additions & 0 deletions .github/workflows/plugins.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
# Validates the two local stdio plugin packages - ChatGPT/Codex under
# packaging/openai-plugin and Claude under packaging/claude-plugin - on every
# PR that touches them or their shared sources, and builds the ChatGPT plugin
# directory ZIP as a run artifact. Both plugins vendor the npm launcher
# verbatim (packaging/mcpb/npm/bin/stackql-mcp.js) plus the pins, licence,
# icon and onboarding skill, rendered by packaging/mcpb/scripts/render-platforms.sh;
# the validators assert byte-equality and the 'package' job re-renders from
# the published release checksums to prove the committed pins are the real
# ones. Directory submission itself is manual (see docs/stackql_release_process.md).

name: stdio-plugins

on:
pull_request:
paths:
- '.agents/plugins/marketplace.json'
- 'packaging/openai-plugin/**'
- 'packaging/claude-plugin/**'
- 'packaging/mcpb/npm/**'
- 'packaging/mcpb/skills/**'
- 'packaging/mcpb/assets/**'
- 'packaging/mcpb/LICENSE'
- 'packaging/mcpb/Makefile'
- 'packaging/mcpb/scripts/render-platforms.sh'
- 'packaging/mcpb/scripts/validate-claude-plugin.py'
- 'packaging/mcpb/scripts/publish-mirror.sh'
- '.github/workflows/plugins.yml'
workflow_dispatch:

permissions:
contents: read

jobs:
smoke:
name: stdio smoke (${{ matrix.os }})
strategy:
fail-fast: false
matrix:
include:
- os: ubuntu-24.04
python: python3
binary: stackql-plugin-smoke
- os: macos-latest
python: python3
binary: stackql-plugin-smoke
- os: windows-latest
python: python
binary: stackql-plugin-smoke.exe
- os: windows-11-arm
python: python
binary: stackql-plugin-smoke.exe
runs-on: ${{ matrix.os }}
timeout-minutes: 15
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v7
with:
# October 2026 security release: TLS hostname CVEs, Brotli RCE, eMudhra CA removal
node-version: '24.22.1'
check-latest: true
- uses: actions/setup-go@v6
with:
go-version-file: go.mod
- name: Build StackQL
env:
CGO_ENABLED: '0'
run: |
go generate ./internal/stackql/dependencies
go build -o ${{ matrix.binary }} ./stackql
- name: Validate the ChatGPT/Codex package
run: ${{ matrix.python }} packaging/openai-plugin/scripts/validate.py
- name: Validate the Claude plugin
run: ${{ matrix.python }} packaging/mcpb/scripts/validate-claude-plugin.py
- name: Smoke test the ChatGPT/Codex launcher
env:
STACKQL_MCP_BIN: ${{ github.workspace }}/${{ matrix.binary }}
run: ${{ matrix.python }} packaging/openai-plugin/scripts/smoke-test.py
- name: Smoke test the Claude launcher
env:
STACKQL_MCP_BIN: ${{ github.workspace }}/${{ matrix.binary }}
run: ${{ matrix.python }} packaging/openai-plugin/scripts/smoke-test.py --launcher packaging/claude-plugin/server/bin/stackql-mcp.js

package:
name: directory packages (render check, claude validate, zip)
runs-on: ubuntu-24.04
timeout-minutes: 15
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v7
with:
# October 2026 security release: TLS hostname CVEs, Brotli RCE, eMudhra CA removal
node-version: '24.22.1'
check-latest: true
- name: Resolve the committed plugin version
id: version
run: echo "version=$(node -p "require('./packaging/mcpb/npm/package.json').version")" >> "$GITHUB_OUTPUT"
- name: Re-render both plugins from the published release checksums
working-directory: packaging/mcpb
run: |
bash scripts/render-platforms.sh --version "${{ steps.version.outputs.version }}" --vector openai-plugin
bash scripts/render-platforms.sh --version "${{ steps.version.outputs.version }}" --vector claude-plugin
- name: Committed plugin payload matches the render
run: git diff --exit-code -- packaging/openai-plugin packaging/claude-plugin
- name: claude plugin validate --strict
run: npx -y @anthropic-ai/claude-code@2.1.318 plugin validate ./packaging/claude-plugin --strict
- name: Build the ChatGPT directory ZIP
working-directory: packaging/mcpb
run: make openai-plugin-zip VERSION="${{ steps.version.outputs.version }}"
- uses: actions/upload-artifact@v7
with:
name: stackql-chatgpt-plugin-${{ steps.version.outputs.version }}
path: packaging/openai-plugin/dist/*.zip
if-no-files-found: error
23 changes: 17 additions & 6 deletions docs/chatgpt-codex-plugin.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,9 @@ remain on the user's machine.

Supported clients:

- ChatGPT desktop app
- Codex CLI
- ChatGPT desktop app, from the plugin directory (Desktop only badge) or the
repository marketplace
- Codex CLI, from the repository marketplace

ChatGPT web cannot run a local stdio server. Plugins are not available in the
Codex IDE extension.
Expand All @@ -21,7 +22,16 @@ reproduced on desktop builds through 26.924. Codex threads in the desktop app
and Codex CLI are unaffected. If a Chat session reports that no StackQL tools
are available, start a Codex thread instead.

## Install
## Install from the ChatGPT plugin directory

In the ChatGPT desktop app, search the plugin directory for StackQL and
install it. The listing carries a Desktop only badge: the plugin installs only
from the desktop app, and its tools are available in threads that run on your
computer. Node.js 24.22.1 or later must be installed (see the next section).
After installing, run the plugin's setup; the bundled `stackql-setup` skill
walks through credentials and a first query.

## Install from the repository marketplace (Codex)

Install Node.js 24.22.1 or later (22.23.4 or 26.12.1 on those release lines; these are the [October 2026 security releases](https://nodejs.org/en/blog/vulnerability/october-2026-security-releases)), then run:

Expand All @@ -33,9 +43,10 @@ codex plugin add stackql@stackql
Restart ChatGPT desktop or Codex. In Codex CLI, use `/plugins` to confirm the
plugin is installed and `/mcp` to confirm that the `stackql` server is active.

The plugin launches a pinned `@stackql/mcp-server` package. On first use, the
package downloads the matching StackQL binary, verifies the published SHA-256,
and caches it under `~/.stackql/mcp-server-bin`.
The plugin ships the StackQL launcher (the same file as the `@stackql/mcp-server`
npm package; it needs only Node.js). On first use it downloads the pinned
StackQL binary for your platform, verifies the published SHA-256, and caches
it under `~/.stackql/mcp-server-bin`.

## Hello world

Expand Down
Loading
Loading