ocaya 2.14.0__tar.gz

ocaya-2.14.0/.github/CODEOWNERS

@@ -0,0 +1,7 @@
+# CODEOWNERS
+
+# Default owners for everything in the repo
+* @mistralai/ocaya
+
+# Owners for specific directories
+# Not needed for now, can be filled later

ocaya-2.14.0/.github/DISCUSSION_TEMPLATE/ideas.yml

@@ -0,0 +1,46 @@
+title: "[Feature Request]: "
+labels: []
+body:
+  - type: markdown
+    attributes:
+      value: >
+        Feature requests work best when they focus on the problem first. Tell us
+        what you're trying to achieve and why existing APIs aren't enough.
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which part of Mistral Vibe would this feature apply to?
+      options:
+        - CLI
+        - ACP
+        - Both
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: >
+        What use case is blocked? Provide a clear and concise description of the problem.
+      placeholder: "I want to be able to use the agent to write a blog post about the benefits of using Mistral Vibe"
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: >
+        Sketch the feature you'd like to see. Code snippets welcome.
+    validations:
+      required: true
+
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context
+      description: Links, screenshots, related issues, etc.

ocaya-2.14.0/.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,59 @@
+name: Bug Report
+description: Tell us about a defect in OCAYA
+title: "bug: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: >
+        Thanks for filing a detailed bug. Fill out every section so we can
+        reproduce the issue quickly
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which part of OCAYA is affected?
+      options:
+        - CLI
+        - ACP
+        - VS Code extension
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What went wrong? Keep it short but specific.
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro
+    attributes:
+      label: Reproduction steps
+      description: >
+        Commands, code, or payloads that trigger the bug. Include any relevant
+        input files or snippets (redact secrets).
+    validations:
+      required: true
+
+  - type: input
+    id: versions
+    attributes:
+      label: Versions / environment
+      description: >
+        Include the version for the affected component, uv or pip when
+        relevant and OS.
+      placeholder: "ocaya 2.14.0, uv 0.9.0 on macOS 15.7"
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs & screenshots
+      description: Paste relevant stack traces, JSON snippets, or console output.
+      render: shell

ocaya-2.14.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Feature request
+    url: https://github.com/mistralai/mistral-vibe/discussions/new?category=ideas
+    about: Suggest a new feature or improvement via GitHub Discussions
+  - name: Ask a question
+    url: https://discord.com/channels/1144547040454508606/1447989080720670915
+    about: Join Mistral AI Discord server for support and discussions
+  - name: Read the docs
+    url: https://docs.mistral.ai/mistral-vibe/introduction
+    about: Read the Mistral Vibe documentation for more information

ocaya-2.14.0/.github/workflows/build-and-upload.yml

@@ -0,0 +1,227 @@
+name: Build and upload
+
+on:
+  release:
+    types: [published]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  configure:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    outputs:
+      matrix: ${{ steps.set-matrix.outputs.matrix }}
+      smoke_matrix: ${{ steps.set-matrix.outputs.smoke_matrix }}
+    steps:
+      - name: Set matrix
+        id: set-matrix
+        run: |
+          # Linux: manylinux_2_28 containers → binary works on glibc >= 2.28 (RHEL 8+, Ubuntu 20.04+)
+          matrix='{
+            "include": [
+              {"runner": "ubuntu-22.04", "os": "linux", "arch": "x86_64", "container": "quay.io/pypa/manylinux_2_28_x86_64"},
+              {"runner": "ubuntu-22.04-arm", "os": "linux", "arch": "aarch64", "container": "quay.io/pypa/manylinux_2_28_aarch64"},
+              {"runner": "macos-15-intel", "os": "darwin", "arch": "x86_64"},
+              {"runner": "macos-14", "os": "darwin", "arch": "aarch64"},
+              {"runner": "windows-2022", "os": "windows", "arch": "x86_64"}
+            ]
+          }'
+          # TODO: Re-enable macOS standalone artifact smoke tests once the PyInstaller
+          # binaries are Developer ID signed and notarized. The direct GitHub zip
+          # download path gets Gatekeeper-assessed via quarantine and currently rejects
+          # ad-hoc signed binaries, even though ocaya-acp continues to work when bundled
+          # through the VS Code extension.
+          smoke_matrix='{
+            "include": [
+              {"runner": "ubuntu-24.04", "os": "linux", "arch": "x86_64"},
+              {"runner": "ubuntu-24.04", "os": "linux", "arch": "x86_64", "tag": "old-glibc", "container": "almalinux:8"},
+              {"runner": "ubuntu-24.04-arm", "os": "linux", "arch": "aarch64"},
+              {"runner": "windows-latest", "os": "windows", "arch": "x86_64"}
+            ]
+          }'
+          echo "matrix=$(echo $matrix | jq -c .)" >> $GITHUB_OUTPUT
+          echo "smoke_matrix=$(echo $smoke_matrix | jq -c .)" >> $GITHUB_OUTPUT
+
+  build-and-upload:
+    needs: configure
+    name: "Build and upload: ${{ matrix.os }}-${{ matrix.arch }}"
+    permissions:
+      contents: read
+    strategy:
+      matrix: ${{ fromJSON(needs.configure.outputs.matrix) }}
+    runs-on: ${{ matrix.runner }}
+    container: ${{ matrix.container || '' }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+
+      - name: Install uv with caching
+        uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
+        with:
+          version: "latest"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        if: ${{ matrix.os != 'linux' }}
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.12"
+
+      - name: Install Python (Linux)
+        if: ${{ matrix.os == 'linux' }}
+        run: |
+          uv python install 3.12
+          # Install patchelf >= 0.18 (yum/EPEL8 ships 0.12 which lacks --clear-execstack)
+          PATCHELF_VERSION=0.18.0
+          curl -sL "https://github.com/NixOS/patchelf/releases/download/${PATCHELF_VERSION}/patchelf-${PATCHELF_VERSION}-$(uname -m).tar.gz" \
+            | tar xz -C /usr/local
+          # python-build-standalone ships libpython with GNU_STACK RWE (executable stack)
+          # which is rejected by hardened Linux kernels — clear it with patchelf
+          find "$(uv python dir)" -name 'libpython*.so*' -exec patchelf --clear-execstack {} \;
+
+      - name: Sync dependencies
+        run: uv sync --no-dev --group build
+
+      - name: Build ACP with PyInstaller
+        run: uv run --no-dev --group build pyinstaller ocaya-acp.spec
+
+      - name: Build CLI with PyInstaller
+        run: uv run --no-dev --group build pyinstaller ocaya.spec
+
+      - name: Clear executable stack on bundled libraries
+        if: ${{ matrix.os == 'linux' }}
+        run: |
+          find dist/ocaya-acp-dir/_internal -name '*.so*' -type f -print0 \
+            | xargs -0 -I{} patchelf --clear-execstack {}
+          patchelf --clear-execstack dist/ocaya-acp-dir/ocaya-acp || true
+          find dist/ocaya-dir/_internal -name '*.so*' -type f -print0 \
+            | xargs -0 -I{} patchelf --clear-execstack {}
+          patchelf --clear-execstack dist/ocaya-dir/ocaya || true
+
+      - name: Get package version
+        id: get_version
+        shell: bash
+        run: echo "version=$(uv version | cut -d' ' -f2)" >> $GITHUB_OUTPUT
+
+      - name: Upload ACP binary as artifact
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+        with:
+          name: ocaya-acp-${{ matrix.os }}-${{ matrix.arch }}-${{ steps.get_version.outputs.version }}
+          path: dist/ocaya-acp-dir/
+
+      - name: Upload CLI binary as artifact
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+        with:
+          name: ocaya-${{ matrix.os }}-${{ matrix.arch }}-${{ steps.get_version.outputs.version }}
+          path: dist/ocaya-dir/
+
+  nix-build:
+    needs: configure
+    name: "Nix build and upload: ${{ matrix.os }}-${{ matrix.arch }}"
+    permissions:
+      contents: read
+    strategy:
+      matrix: ${{ fromJSON(needs.configure.outputs.matrix) }}
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - name: Checkout repository
+        if: matrix.os != 'windows'
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+
+      - name: Install Nix
+        if: matrix.os != 'windows'
+        uses: cachix/install-nix-action@4e002c8ec80594ecd40e759629461e26c8abed15 # v31
+
+      - name: Build with Nix
+        if: matrix.os != 'windows'
+        shell: bash
+        run: |
+          nix build .#
+
+      - name: Nix Smoke Test
+        if: matrix.os != 'windows'
+        shell: bash
+        run: |
+          nix run .# -- --version
+
+  smoke-test:
+    needs: [configure, build-and-upload]
+    name: "Test: ${{ matrix.os }}-${{ matrix.arch }}${{ matrix.tag && format('-{0}', matrix.tag) || '' }}"
+    permissions:
+      contents: read
+    strategy:
+      matrix: ${{ fromJSON(needs.configure.outputs.smoke_matrix) }}
+    runs-on: ${{ matrix.runner }}
+    container: ${{ matrix.container || '' }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+
+      - name: Set up Python
+        if: ${{ !matrix.container }}
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up Python (container)
+        if: ${{ matrix.container }}
+        run: yum install -y python3.11 python3.11-pip
+
+      - name: Install smoke test deps
+        run: ${{ matrix.container && 'python3.11' || 'python' }} -m pip install agent-client-protocol==0.10.1
+
+      - name: Download ACP artifact
+        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5
+        with:
+          pattern: ocaya-acp-${{ matrix.os }}-${{ matrix.arch }}-*
+          merge-multiple: true
+          path: dist/ocaya-acp-dir
+
+      - name: Download CLI artifact
+        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5
+        with:
+          pattern: ocaya-${{ matrix.os }}-${{ matrix.arch }}-*
+          merge-multiple: true
+          path: dist/ocaya-dir
+
+      - name: Run ACP smoke tests
+        run: ${{ matrix.container && 'python3.11' || 'python' }} tests/acp/smoke_binary.py dist/ocaya-acp-dir
+
+  attach-to-release:
+    needs: [build-and-upload, smoke-test]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release'
+    permissions:
+      contents: write
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5
+        with:
+          path: artifacts
+
+      - name: Zip artifacts
+        run: |
+          mkdir release-assets
+          for dir in artifacts/*; do
+            name=$(basename "$dir")
+            if [ -f "$dir/ocaya-acp" ] || [ -f "$dir/ocaya-acp.exe" ]; then
+              chmod -f +x "$dir/ocaya-acp" 2>/dev/null || true
+              (cd "$dir" && zip -r "../../release-assets/${name}.zip" .)
+            elif [ -f "$dir/ocaya" ] || [ -f "$dir/ocaya.exe" ]; then
+              chmod -f +x "$dir/ocaya" 2>/dev/null || true
+              (cd "$dir" && zip -r "../../release-assets/${name}.zip" .)
+            fi
+          done
+
+      - name: Attach binaries to release
+        uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b # v2
+        with:
+          files: release-assets/*.zip
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

ocaya-2.14.0/.github/workflows/ci.yml

@@ -0,0 +1,132 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  PYTHON_VERSION: "3.12"
+
+jobs:
+  pre-commit:
+    name: Pre-commit
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+
+      - name: Install uv with caching
+        uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
+        with:
+          version: "latest"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Sync dependencies
+        run: uv sync --all-extras
+
+      - name: Install pip (required by pre-commit)
+        run: uv pip install pip
+
+      - name: Add virtual environment to PATH
+        run: echo "$(pwd)/.venv/bin" >> $GITHUB_PATH
+
+      - name: Cache pre-commit
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4
+        with:
+          path: ~/.cache/pre-commit
+          key: pre-commit-${{ hashFiles('.pre-commit-config.yaml') }}
+
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files --show-diff-on-failure
+
+  tests:
+    name: Tests
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+
+      - name: Install uv with caching
+        uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
+        with:
+          version: "latest"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Sync dependencies
+        run: uv sync --all-extras
+
+      - name: Verify CLI can start
+        run: |
+          uv run ocaya --help
+          uv run ocaya-acp --help
+
+      - name: Install ripgrep
+        run: sudo apt-get update && sudo apt-get install -y ripgrep
+
+      - name: Run tests
+        run: uv run pytest --ignore tests/snapshots
+
+  snapshot-tests:
+    name: Snapshot Tests
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+
+      - name: Install uv with caching
+        uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
+        with:
+          version: "latest"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Sync dependencies
+        run: uv sync --all-extras
+
+      - name: Run snapshot tests
+        id: snapshot-tests
+        run: uv run pytest tests/snapshots
+        continue-on-error: true
+
+      - name: Upload snapshot report
+        if: steps.snapshot-tests.outcome == 'failure'
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+        with:
+          name: snapshot-report
+          path: snapshot_report.html
+          if-no-files-found: warn
+          retention-days: 3
+
+      - name: Fail job if snapshot tests failed
+        if: steps.snapshot-tests.outcome == 'failure'
+        run: |
+          echo "Snapshot tests failed, failing job."
+          exit 1

ocaya-2.14.0/.github/workflows/issue-labeler.yml

@@ -0,0 +1,62 @@
+name: Issue Labeler
+
+on:
+    issues:
+        types: [opened]
+
+jobs:
+    label-component:
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+            issues: write
+        steps:
+            - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+
+            - name: Parse bug report form
+              id: parse-bug
+              uses: stefanbuck/github-issue-parser@25f1485edffc1fee3ea68eb9f59a72e58720ffc4 # v3
+              with:
+                  template-path: .github/ISSUE_TEMPLATE/bug-report.yml
+              continue-on-error: true
+
+            - name: Parse feature request form
+              id: parse-feature
+              uses: stefanbuck/github-issue-parser@25f1485edffc1fee3ea68eb9f59a72e58720ffc4 # v3
+              with:
+                  template-path: .github/ISSUE_TEMPLATE/feature-request.yml
+              continue-on-error: true
+
+            - name: Apply component label
+              uses: actions/github-script@f28e40c7f34bde8b3046d885e986cb6290c5673b # v7
+              with:
+                  script: |
+                      // Get component from either bug report or feature request
+                      const bugComponent = '${{ steps.parse-bug.outputs.issueparser_component }}';
+                      const featureComponent = '${{ steps.parse-feature.outputs.issueparser_component }}';
+                      const component = bugComponent || featureComponent;
+
+                      if (!component) {
+                        console.log('No component field found, skipping labeling');
+                        return;
+                      }
+
+                      const labels = [];
+
+                      if (component === 'CLI') {
+                        labels.push('CLI');
+                      } else if (component === 'ACP') {
+                        labels.push('ACP');
+                      } else if (component === 'VS Code extension') {
+                        labels.push('VS Code extension');
+                      }
+
+                      if (labels.length > 0) {
+                        await github.rest.issues.addLabels({
+                          owner: context.repo.owner,
+                          repo: context.repo.repo,
+                          issue_number: context.issue.number,
+                          labels: labels
+                        });
+                        console.log(`Added labels: ${labels.join(', ')}`);
+                      }

ocaya-2.14.0/.github/workflows/release.yml

@@ -0,0 +1,45 @@
+name: Release to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  release-pypy:
+    name: Release to Pypi
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mistral-vibe
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+
+      - name: Set up Python
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@1e862dfacbd1d6d858c55d9b792c756523627244 # v7
+
+      - name: Install dependencies
+        run: uv sync --locked --dev
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish distribution to PyPI
+        if: github.repository == 'mistralai/mistral-vibe'
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0