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
101 changes: 74 additions & 27 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ jobs:
version: ${{ steps.metadata.outputs.version }}
image: ${{ steps.metadata.outputs.image }}
tags: ${{ steps.metadata.outputs.tags }}
local_tags: ${{ steps.metadata.outputs.local_tags }}
local_browser_tags: ${{ steps.metadata.outputs.local_browser_tags }}
env:
PIP_DISABLE_PIP_VERSION_CHECK: '1'
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1'
Expand Down Expand Up @@ -56,6 +58,22 @@ jobs:
run: |
npm --prefix apps/discord-agent ci --ignore-scripts --no-audit --no-fund
npm test
- name: Verify the locked local MCP package
run: |
npm ci --prefix packages/local-mcp --ignore-scripts --no-audit --no-fund
npm run test:local
- name: Package the portable local deployment kit
run: node scripts/package-local-release.mjs "$RUNNER_TEMP/local-release-kit"
- name: Retain the local deployment kit
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: local-release-kit
path: |
${{ runner.temp }}/local-release-kit/plompy-local-${{ steps.metadata.outputs.version }}.tar.gz
${{ runner.temp }}/local-release-kit/plompy-local-${{ steps.metadata.outputs.version }}.tar.gz.sha256
if-no-files-found: error
retention-days: 7
overwrite: true
- name: Keep the pinned Node executable outside the writable hosted tool cache
run: |
runtime_dir=$(sudo mktemp -d /tmp/plompy-ci-node-XXXXXX)
Expand All @@ -81,16 +99,18 @@ jobs:
python -m pytest -q

smoke:
name: Offline container smoke / ${{ matrix.arch }}
name: Offline container smoke / ${{ matrix.variant }} / ${{ matrix.arch }}
needs: verify
strategy:
fail-fast: false
matrix:
include:
- arch: amd64
runner: ubuntu-24.04
- arch: arm64
runner: ubuntu-24.04-arm
- { variant: engine, arch: amd64, runner: ubuntu-24.04, dockerfile: Dockerfile, target: runtime }
- { variant: engine, arch: arm64, runner: ubuntu-24.04-arm, dockerfile: Dockerfile, target: runtime }
- { variant: local, arch: amd64, runner: ubuntu-24.04, dockerfile: Dockerfile.local, target: local }
- { variant: local, arch: arm64, runner: ubuntu-24.04-arm, dockerfile: Dockerfile.local, target: local }
- { variant: local-browser, arch: amd64, runner: ubuntu-24.04, dockerfile: Dockerfile.local, target: local-browser }
- { variant: local-browser, arch: arm64, runner: ubuntu-24.04-arm, dockerfile: Dockerfile.local, target: local-browser }
runs-on: ${{ matrix.runner }}
timeout-minutes: 20
steps:
Expand All @@ -112,33 +132,45 @@ jobs:
sudo apt-get install -y --no-install-recommends skopeo
mkdir -p "$RUNNER_TEMP/release-image" "$RUNNER_TEMP/release-layout"
- name: Load the container sandbox profile on this ephemeral runner
env:
VARIANT: ${{ matrix.variant }}
run: |
if docker info --format '{{json .SecurityOptions}}' | grep -q 'name=apparmor'; then
sudo install -m 0644 scripts/docker-apparmor /etc/apparmor.d/plompy-engine-container
sudo apparmor_parser -r -W /etc/apparmor.d/plompy-engine-container
printf 'PLOMPY_DOCKER_APPARMOR_PROFILE=plompy-engine-container\n' >> "$GITHUB_ENV"
if [ "$VARIANT" = engine ]; then
profile=plompy-engine-container
source=scripts/docker-apparmor
else
profile=plompy-local-container
source=scripts/docker-local-apparmor
fi
sudo install -m 0644 "$source" "/etc/apparmor.d/$profile"
sudo apparmor_parser -r -W "/etc/apparmor.d/$profile"
printf 'PLOMPY_DOCKER_APPARMOR_PROFILE=%s\n' "$profile" >> "$GITHUB_ENV"
fi
- name: Build the release artifact once without registry credentials
uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
with:
context: .
file: ${{ matrix.dockerfile }}
target: ${{ matrix.target }}
push: false
platforms: linux/${{ matrix.arch }}
outputs: type=oci,dest=${{ runner.temp }}/release-image/engine.oci.tar
tags: ${{ needs.verify.outputs.image }}:sha-${{ github.sha }}-${{ matrix.arch }}
outputs: type=oci,dest=${{ runner.temp }}/release-image/image.oci.tar
tags: ${{ needs.verify.outputs.image }}:sha-${{ github.sha }}-${{ matrix.variant }}-${{ matrix.arch }}
build-args: |
VERSION=${{ needs.verify.outputs.version }}
REVISION=${{ github.sha }}
provenance: mode=max
sbom: true
cache-from: type=gha,scope=release-smoke-${{ matrix.arch }}
cache-to: type=gha,scope=release-smoke-${{ matrix.arch }},mode=max
cache-from: type=gha,scope=release-smoke-${{ matrix.variant }}-${{ matrix.arch }}
cache-to: type=gha,scope=release-smoke-${{ matrix.variant }}-${{ matrix.arch }},mode=max
- name: Load exactly the OCI artifact and verify its runtime identity
env:
ARCH: ${{ matrix.arch }}
VARIANT: ${{ matrix.variant }}
VERSION: ${{ needs.verify.outputs.version }}
run: |
archive="$RUNNER_TEMP/release-image/engine.oci.tar"
archive="$RUNNER_TEMP/release-image/image.oci.tar"
report="$RUNNER_TEMP/release-image/tested.json"
tar -xf "$archive" -C "$RUNNER_TEMP/release-layout"
node scripts/release-oci.mjs inspect "$RUNNER_TEMP/release-layout" "$ARCH" "$GITHUB_SHA" "$VERSION" > "$report"
Expand All @@ -148,21 +180,29 @@ jobs:
config_path=$(tar -xOf "$RUNNER_TEMP/loaded-runtime.tar" manifest.json | jq -er 'if length == 1 then .[0].Config else error("Expected one loaded runtime") end')
actual="sha256:$(tar -xOf "$RUNNER_TEMP/loaded-runtime.tar" "$config_path" | sha256sum | cut -d ' ' -f 1)"
test "$actual" = "$(jq -r .configDigest "$report")"
sh scripts/docker-smoke.sh plompy-engine:smoke
(cd "$RUNNER_TEMP/release-image" && sha256sum engine.oci.tar > engine.oci.tar.sha256)
if [ "$VARIANT" = engine ]; then
sh scripts/docker-smoke.sh plompy-engine:smoke
else
node scripts/docker-local-smoke.mjs plompy-engine:smoke "$VARIANT"
fi
(cd "$RUNNER_TEMP/release-image" && sha256sum image.oci.tar > image.oci.tar.sha256)
- name: Retain only the tested OCI artifact and digest report
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: tested-image-${{ matrix.arch }}
name: tested-image-${{ matrix.variant }}-${{ matrix.arch }}
path: ${{ runner.temp }}/release-image/
if-no-files-found: error
compression-level: 0
retention-days: 1
overwrite: true

publish:
name: Publish GHCR image
name: Publish GHCR image / ${{ matrix.variant }}
needs: [verify, smoke]
strategy:
fail-fast: false
matrix:
variant: [engine, local, local-browser]
runs-on: ubuntu-24.04
timeout-minutes: 20
permissions:
Expand All @@ -185,11 +225,17 @@ jobs:
run: |
sudo apt-get update
sudo apt-get install -y --no-install-recommends skopeo
- name: Download the artifacts from this verified workflow run
- name: Download the verified amd64 artifact
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
with:
name: tested-image-${{ matrix.variant }}-amd64
path: ${{ runner.temp }}/release-images/tested-image-${{ matrix.variant }}-amd64
digest-mismatch: error
- name: Download the verified arm64 artifact
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
with:
pattern: tested-image-*
path: ${{ runner.temp }}/release-images
name: tested-image-${{ matrix.variant }}-arm64
path: ${{ runner.temp }}/release-images/tested-image-${{ matrix.variant }}-arm64
digest-mismatch: error
- name: Authenticate only after verification passes
uses: docker/login-action@81c6f93d4bc991e510b342a00b419b3bb4efc5c6 # v4.7.0
Expand All @@ -200,21 +246,22 @@ jobs:
- name: Promote tested bytes and assemble the release index without rebuilding
env:
IMAGE: ${{ needs.verify.outputs.image }}
TAGS: ${{ needs.verify.outputs.tags }}
TAGS: ${{ matrix.variant == 'local' && needs.verify.outputs.local_tags || matrix.variant == 'local-browser' && needs.verify.outputs.local_browser_tags || needs.verify.outputs.tags }}
VARIANT: ${{ matrix.variant }}
VERSION: ${{ needs.verify.outputs.version }}
run: |
sources=()
reports=()
for arch in amd64 arm64; do
artifact="$RUNNER_TEMP/release-images/tested-image-$arch"
(cd "$artifact" && sha256sum --check engine.oci.tar.sha256)
artifact="$RUNNER_TEMP/release-images/tested-image-$VARIANT-$arch"
(cd "$artifact" && sha256sum --check image.oci.tar.sha256)
layout="$RUNNER_TEMP/promote-$arch"
mkdir -p "$layout"
tar -xf "$artifact/engine.oci.tar" -C "$layout"
tar -xf "$artifact/image.oci.tar" -C "$layout"
node scripts/release-oci.mjs inspect "$layout" "$arch" "$GITHUB_SHA" "$VERSION" > "$layout/verified.json"
cmp "$artifact/tested.json" "$layout/verified.json"
ref="$IMAGE:sha-$GITHUB_SHA-$arch"
skopeo copy --all --preserve-digests --authfile "$HOME/.docker/config.json" --digestfile "$layout/published.digest" "oci-archive:$artifact/engine.oci.tar" "docker://$ref"
ref="$IMAGE:sha-$GITHUB_SHA-$VARIANT-$arch"
skopeo copy --all --preserve-digests --authfile "$HOME/.docker/config.json" --digestfile "$layout/published.digest" "oci-archive:$artifact/image.oci.tar" "docker://$ref"
expected=$(jq -r .indexDigest "$artifact/tested.json")
test "$(cat "$layout/published.digest")" = "$expected"
sources+=("$IMAGE@$expected")
Expand All @@ -229,4 +276,4 @@ jobs:
DIGEST=$(jq -er '."containerimage.descriptor".digest' "$RUNNER_TEMP/release-metadata.json")
docker buildx imagetools inspect --raw "$IMAGE@$DIGEST" > "$RUNNER_TEMP/published-index.json"
node scripts/release-oci.mjs verify-index "$RUNNER_TEMP/published-index.json" "${reports[@]}"
printf '## Container image\n\n`%s@%s`\n\nPin this digest for repeatable deployments.\n' "$IMAGE" "$DIGEST" >> "$GITHUB_STEP_SUMMARY"
printf '## Container image: %s\n\n`%s@%s`\n\nPin this digest for repeatable deployments.\n' "$VARIANT" "$IMAGE" "$DIGEST" >> "$GITHUB_STEP_SUMMARY"
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
# Changelog

## 0.13.0 (2026-11-12): Local tools for your agent

- Add an authenticated local MCP gateway for independently running Codex, Claude Code, OpenCode and compatible clients, without Discord or a second model account in the container.
- Publish prebuilt `0.13.0-local` and `0.13.0-local-browser` variants for Linux amd64 and arm64, with a standalone Compose download. The existing default image remains the Discord/Codex engine.
- Provide bounded public page reads, optional sandboxed Chromium, selected read-only integration tools and durable CSV, JSON and Markdown artifacts. Keep email sending and arbitrary shell/browser execution outside the research profile.
- Export client-specific configuration with environment references for the local access token. Document optional Ollama model hosting, integration credentials, source-backed research and verification limits at [plompy.dev/docs](https://plompy.dev/docs/).
- Test each release image's actual OCI runtime before registry promotion, retain provenance and SBOMs, and publish the tested bytes without rebuilding.
- Retain existing Discord behavior, SQLite schema 6, private volumes and recovery semantics. No private deployment or client account is changed automatically.

## 0.12.0 (2026-11-11): Plompy Engine

- Rebrand the project, repository links, packages, CLI, configuration examples and container to **plompy-engine**.
Expand Down
2 changes: 1 addition & 1 deletion Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ COPY packages/mcp-bridge/package.json packages/mcp-bridge/package-lock.json ./
RUN npm ci --omit=dev --ignore-scripts --no-audit --no-fund

FROM node:26.13.0-bookworm-slim@sha256:add5c17c14752c54d2f3d519ec46a3815684d41c33f198bcb09fb998f7dcbf68 AS runtime
ARG VERSION=0.12.0
ARG VERSION=0.13.0
ARG REVISION=unknown
LABEL org.opencontainers.image.title="Plompy Engine" \
org.opencontainers.image.description="Self-hosted Discord agent engine with durable jobs and private Markdown memory" \
Expand Down
6 changes: 5 additions & 1 deletion Dockerfile.local
Original file line number Diff line number Diff line change
@@ -1,9 +1,13 @@
# syntax=docker/dockerfile:1
FROM node:26.13.0-bookworm-slim@sha256:add5c17c14752c54d2f3d519ec46a3815684d41c33f198bcb09fb998f7dcbf68 AS local-base
ARG VERSION=0.13.0
ARG REVISION=unknown
LABEL org.opencontainers.image.title="Plompy Local MCP" \
org.opencontainers.image.description="Local integration tools for an external MCP client" \
org.opencontainers.image.source="https://github.com/dalkedev/plompy-engine" \
org.opencontainers.image.licenses="MIT"
org.opencontainers.image.licenses="MIT" \
org.opencontainers.image.version="${VERSION}" \
org.opencontainers.image.revision="${REVISION}"
RUN apt-get update \
&& apt-get install -y --no-install-recommends ca-certificates gh libatomic1 tini \
&& rm -rf /var/lib/apt/lists/*
Expand Down
26 changes: 17 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,20 +41,28 @@ is required inside the container. The existing Discord mode remains available.
quality and tool calling depend on the chosen model; hosted integrations still
receive their requests.

This mode is **unreleased source**. Build the checked-out source locally; the existing
`0.12.0` image does not contain it. It does not expose email sending or general shell
execution tools. Paid provider calls and actual Ollama inference have not been tested.
Plompy Local **0.13.0** includes ready-made Linux `amd64` and `arm64` images:
`ghcr.io/dalkedev/plompy-engine:0.13.0-local` and the optional
`ghcr.io/dalkedev/plompy-engine:0.13.0-local-browser`. Download the small starter kit;
no source checkout or host Node installation is needed. It does not expose email
sending or general shell execution tools. Paid provider calls and actual Ollama
inference have not been tested.

[Docker quickstart](docs/local/quickstart.md) · [Codex CLI](docs/local/codex.md) ·
[Claude Code](docs/local/claude-code.md) · [OpenCode](docs/local/opencode.md) ·
[Ollama](docs/local/ollama.md) · [Integration matrix](docs/local/integrations.md) ·
[Verification and limits](docs/local/compatibility.md)

```sh
docker compose -f compose.local.yaml build local
docker compose -f compose.local.yaml run --rm -T local node scripts/integrations.mjs init --mode local
docker compose -f compose.local.yaml up -d local
docker compose -f compose.local.yaml exec -T local node scripts/integrations.mjs test --mode local
mkdir -m 700 plompy-local
cd plompy-local
curl -fL https://github.com/dalkedev/plompy-engine/releases/download/v0.13.0/plompy-local-0.13.0.tar.gz \
-o plompy-local-0.13.0.tar.gz
tar -xzf plompy-local-0.13.0.tar.gz
docker compose pull local
docker compose run --rm -T local node scripts/integrations.mjs init --mode local
docker compose up -d local
docker compose exec -T local node scripts/integrations.mjs test --mode local
```

Use the quickstart to export the access token into your client's environment, select
Expand Down Expand Up @@ -86,7 +94,7 @@ For containers, start with the [Docker guide](docs/docker.md).
### 1. Install and try the offline demo

```sh
git clone --branch v0.12.0 --depth 1 https://github.com/dalkedev/plompy-engine.git
git clone --branch v0.13.0 --depth 1 https://github.com/dalkedev/plompy-engine.git
cd plompy-engine
npm --prefix apps/discord-agent ci --ignore-scripts
npm run build
Expand Down Expand Up @@ -349,7 +357,7 @@ The engine commits selected Markdown locally; **it does not push memory**. Keep
remote separate from this public repository. Treat transcripts, credentials, browser profiles
and artifacts as private data. Alternative runners have their own private directories.

Version **0.12.0 uses SQLite schema 6**, retaining owner-bound repositories and durable code-diff
Version **0.13.0 uses SQLite schema 6**, retaining owner-bound repositories and durable code-diff
evidence. Take a [verified pre-upgrade snapshot](docs/state-backups.md);
rollback requires compatible state and reconciliation of later actions. Do not point older code
at a migrated database.
Expand Down
4 changes: 2 additions & 2 deletions apps/discord-agent/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion apps/discord-agent/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@plompy/discord-agent",
"version": "0.12.0",
"version": "0.13.0",
"private": true,
"type": "module",
"engines": {
Expand Down
2 changes: 1 addition & 1 deletion compose.yaml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name: plompy-engine
services:
engine:
image: ${PLOMPY_IMAGE:-ghcr.io/dalkedev/plompy-engine:0.12.0}
image: ${PLOMPY_IMAGE:-ghcr.io/dalkedev/plompy-engine:0.13.0}
build:
context: .
env_file:
Expand Down
8 changes: 5 additions & 3 deletions docs/docker.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,10 @@

This page covers the existing Discord engine container. For the separate local
integration server used by Codex CLI, Claude Code, OpenCode and other MCP clients,
see [Plompy Local Docker quickstart](local/quickstart.md). The local mode starts
without Discord or a model account inside the container.
see [Plompy Local Docker quickstart](local/quickstart.md). The 0.13.0 starter kit
pulls `0.13.0-local` or `0.13.0-local-browser` for Linux amd64/arm64 and starts
without Discord or a model account inside the container. Keep the Local kit in a
separate directory; its `compose.yaml` is different from this engine setup.

For installations created before 0.12, follow the [Plompy migration guide](migration-plompy.md) and use `compose.legacy.yaml` to retain existing volumes. Do not initialize empty replacement volumes.

Expand All @@ -29,7 +31,7 @@ and Discord IDs, then restrict the file to your account:
```sh
chmod 600 /absolute/private/plompy.env
export PLOMPY_ENV_FILE=/absolute/private/plompy.env
export PLOMPY_IMAGE=ghcr.io/dalkedev/plompy-engine:0.12.0
export PLOMPY_IMAGE=ghcr.io/dalkedev/plompy-engine:0.13.0
docker compose config --quiet
docker compose pull
docker compose run --rm engine init
Expand Down
8 changes: 5 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,16 @@ your own Linux machine. The public edition runs one shared worker. Start with Co
Claude Code and OpenCode are experimental host adapters, and the published Docker
image supports Codex only.

## Local MCP preview
## Plompy Local 0.13.0

[Plompy Local](local/introduction.md) adds selected tools in Docker for a host agent,
without Discord setup. Start with the [local Docker quickstart](local/quickstart.md),
then [connect Codex, Claude Code, OpenCode or another MCP client](local/other-clients.md).
[Ollama](local/ollama.md) is an optional local model provider for a compatible agent.
This source-built preview is separate from the published 0.12.0 Discord image;
read the [verification record](local/compatibility.md) for tested boundaries.
The 0.13.0 starter kit pulls ready-made core or browser images for Linux amd64/arm64.
These are separate from the Discord engine image. Read the
[verification record](local/compatibility.md) for tested boundaries, or
[build from source](local/source-build.md) for development.

## Start here

Expand Down
2 changes: 1 addition & 1 deletion docs/local/artifacts.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ The files remain in a Docker volume until you copy them out. From your host, cre

```sh
mkdir -m 700 plompy-results
docker compose -f compose.local.yaml cp \
docker compose cp \
local:/var/lib/plompy-local/artifacts/. ./plompy-results/
```

Expand Down
Loading