runtrace-ai 0.1.2__tar.gz

runtrace_ai-0.1.2/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "runtrace",
+  "interface": {
+    "displayName": "RunTrace"
+  },
+  "plugins": [
+    {
+      "name": "runtrace",
+      "source": {
+        "source": "local",
+        "path": "./plugins/runtrace"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

runtrace_ai-0.1.2/.claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "runtrace",
+  "description": "Official RunTrace plugins for research agents.",
+  "owner": {
+    "name": "RunTrace contributors"
+  },
+  "plugins": [
+    {
+      "name": "runtrace",
+      "description": "Persistent experiment memory and run tracking for autonomous research agents.",
+      "source": "./plugins/runtrace",
+      "category": "development",
+      "homepage": "https://github.com/vano04/RunTrace"
+    }
+  ]
+}

runtrace_ai-0.1.2/.dockerignore

@@ -0,0 +1,20 @@
+.git
+.github
+.DS_Store
+.env
+.env.*
+.venv
+.uv-cache
+__pycache__
+*.py[cod]
+*.db
+data
+apps/web/node_modules
+apps/web/.next
+tests/.runtime
+.pytest_cache
+.coverage
+htmlcov
+docs
+examples
+tests

runtrace_ai-0.1.2/.env.example

@@ -0,0 +1,21 @@
+# Native development defaults. Docker Compose supplies service-local values for
+# the database, API, and artifact paths.
+RUNTRACE_DATABASE_URL=postgresql+psycopg://runtrace:runtrace@localhost:5432/runtrace
+RUNTRACE_BASE_URL=http://localhost:8000
+# Client-only bearer token. Create it in Access -> Your agent tokens; never commit it.
+RUNTRACE_API_TOKEN=
+RUNTRACE_ARTIFACT_PATH=./data/artifacts
+RUNTRACE_CORS_ORIGINS=http://localhost:3000
+RUNTRACE_SEED_DEMO=false
+RUNTRACE_DEV=false
+RUNTRACE_AUTO_MIGRATE=true
+RUNTRACE_MAX_ARTIFACT_SIZE=10485760
+RUNTRACE_CLAIM_TIMEOUT_SECONDS=300
+RUNTRACE_EMBEDDINGS_ENABLED=true
+RUNTRACE_EMBEDDING_MODEL=BAAI/bge-small-en-v1.5
+RUNTRACE_EMBEDDING_CACHE_PATH=./data/models
+RUNTRACE_SECURE_SESSION_COOKIE=false
+# One-time migration aid for a passkey-era owner. Remove after the first start.
+RUNTRACE_OWNER_RECOVERY_PASSWORD=
+RUNTRACE_SESSION_TTL_HOURS=168
+RUNTRACE_SETUP_LINK_TTL_HOURS=24

runtrace_ai-0.1.2/.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  python:
+    name: Python tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.28"
+          enable-cache: true
+      - name: Install Python dependencies
+        run: uv sync --locked --all-extras
+      - name: Run tests
+        run: uv run pytest
+
+  web:
+    name: Web lint and build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: apps/web/package-lock.json
+      - name: Install dependencies
+        run: npm --prefix apps/web ci
+      - name: Lint
+        run: npm --prefix apps/web run lint
+      - name: Build
+        run: npm --prefix apps/web run build
+      - name: Validate Compose configuration
+        run: docker compose config --quiet

runtrace_ai-0.1.2/.github/workflows/containers.yml

@@ -0,0 +1,92 @@
+name: Publish containers
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: Git ref to build
+        required: true
+        default: v0.1.2
+      version:
+        description: Container version tag without the v prefix
+        required: true
+        default: 0.1.2
+
+permissions:
+  contents: read
+  packages: write
+  id-token: write
+  attestations: write
+
+concurrency:
+  group: containers-${{ github.event.release.tag_name || inputs.version }}
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    name: Publish ${{ matrix.title }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - title: RunTrace runtime
+            image: ghcr.io/vano04/runtrace
+            context: .
+            file: ./Dockerfile.api
+            cache: runtime
+          - title: RunTrace web
+            image: ghcr.io/vano04/runtrace-web
+            context: ./apps/web
+            file: ./apps/web/Dockerfile
+            cache: web
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ github.event.release.tag_name || inputs.ref }}
+      - uses: docker/setup-qemu-action@c7c53464625b32c7a7e944ae62b3e17d2b600130 # v3
+      - uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3
+      - name: Log in to GHCR
+        uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9 # v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Resolve version
+        id: version
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+          INPUT_VERSION: ${{ inputs.version }}
+        run: echo "version=${RELEASE_TAG#v}${INPUT_VERSION}" >> "$GITHUB_OUTPUT"
+      - name: Generate image metadata
+        id: meta
+        uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5
+        with:
+          images: ${{ matrix.image }}
+          tags: |
+            type=raw,value=${{ steps.version.outputs.version }}
+            type=raw,value=latest
+          labels: |
+            org.opencontainers.image.title=${{ matrix.title }}
+            org.opencontainers.image.source=https://github.com/vano04/RunTrace
+            org.opencontainers.image.version=${{ steps.version.outputs.version }}
+      - name: Build and publish
+        id: push
+        uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6
+        with:
+          context: ${{ matrix.context }}
+          file: ${{ matrix.file }}
+          platforms: linux/amd64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha,scope=${{ matrix.cache }}
+          cache-to: type=gha,mode=max,scope=${{ matrix.cache }}
+      - name: Attest image provenance
+        uses: actions/attest@a1948c3f048ba23858d222213b7c278aabede763 # v4
+        with:
+          subject-name: ${{ matrix.image }}
+          subject-digest: ${{ steps.push.outputs.digest }}
+          push-to-registry: true

runtrace_ai-0.1.2/.github/workflows/publish-pypi.yml

@@ -0,0 +1,20 @@
+name: Publish Python package
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.28"
+      - run: uv build
+      - run: uv publish --trusted-publishing always

runtrace_ai-0.1.2/.github/workflows/release.yml

@@ -0,0 +1,30 @@
+name: Release artifacts
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.28"
+      - name: Build wheel and source distribution
+        run: uv build
+      - name: Verify distributions
+        run: uv run --with twine twine check dist/*
+      - uses: actions/upload-artifact@v6
+        with:
+          name: python-distributions
+          path: dist/*
+          if-no-files-found: error
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create "${{ github.ref_name }}" dist/* --generate-notes --verify-tag

runtrace_ai-0.1.2/.gitignore

@@ -0,0 +1,41 @@
+# Operating systems and editors
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+*.swp
+
+# Local configuration and secrets
+.env
+.env.*
+!.env.example
+*.pem
+
+# Python
+.venv/
+.uv-cache/
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+*.db
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Node.js and Next.js
+node_modules/
+.next/
+out/
+coverage/
+*.tsbuildinfo
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Runtime data
+data/
+tests/.runtime/

runtrace_ai-0.1.2/Dockerfile.api

@@ -0,0 +1,25 @@
+FROM python:3.13-slim AS builder
+WORKDIR /app
+COPY pyproject.toml README.md uv.lock ./
+COPY alembic.ini ./
+COPY apps/api ./apps/api
+COPY apps/mcp ./apps/mcp
+COPY packages ./packages
+RUN pip wheel --no-cache-dir --wheel-dir /wheels '.[server,mcp,embeddings]'
+
+FROM python:3.13-slim AS runtime
+WORKDIR /app
+LABEL org.opencontainers.image.source="https://github.com/vano04/RunTrace"
+LABEL org.opencontainers.image.description="RunTrace API, CLI, SDK, and MCP runtime"
+COPY --from=builder /wheels /wheels
+RUN pip install --no-cache-dir /wheels/* \
+    && rm -rf /wheels \
+    && useradd --create-home --uid 10001 runtrace \
+    && mkdir -p /data/artifacts /data/models \
+    && chown -R runtrace:runtrace /data
+COPY alembic.ini ./
+COPY apps/api/migrations ./apps/api/migrations
+ENV RUNTRACE_ARTIFACT_PATH=/data/artifacts
+EXPOSE 8000
+USER runtrace
+CMD ["sh", "-c", "alembic upgrade head && exec uvicorn runtrace_api.main:app --host 0.0.0.0 --port 8000"]