orcheo 0.0.1__tar.gz

orcheo-0.0.1/.bumpversion.cfg

@@ -0,0 +1,13 @@
+[bumpversion]
+current_version = 0.0.1
+commit = true
+tag = true
+tag_name = "core-v{new_version}"
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
+
+[bumpversion:file:uv.lock]
+search = version = "{current_version}"
+replace = version = "{new_version}"

orcheo-0.0.1/.cursor/rules/components.mdc

@@ -0,0 +1,9 @@
+---
+description: 
+globs: 
+alwaysApply: false
+---
+# Components Guide
+
+- UI components are in [src/components/](mdc:src/components)
+- Node configuration UI: [src/components/NodeConfigPage.tsx](mdc:src/components/NodeConfigPage.tsx)

orcheo-0.0.1/.cursor/rules/docs.mdc

@@ -0,0 +1,9 @@
+---
+description: 
+globs: 
+alwaysApply: false
+---
+# Documentation Guide
+
+- Project documentation is in [docs/](mdc:docs)
+- Node documentation: [docs/node.md](mdc:docs/node.md)

orcheo-0.0.1/.cursor/rules/nodes-and-edges.mdc

@@ -0,0 +1,13 @@
+---
+description: 
+globs: 
+alwaysApply: false
+---
+# Nodes and Edges Guide
+
+- Node logic is in [src/nodes/](mdc:src/nodes):
+  - Base node component: [src/nodes/BaseNode.tsx](mdc:src/nodes/BaseNode.tsx)
+  - Node types: [src/nodes/types.ts](mdc:src/nodes/types.ts)
+  - Node exports: [src/nodes/index.ts](mdc:src/nodes/index.ts)
+- Edge logic is in [src/edges/](mdc:src/edges):
+  - Edge exports: [src/edges/index.ts](mdc:src/edges/index.ts)

orcheo-0.0.1/.cursor/rules/project-structure.mdc

@@ -0,0 +1,17 @@
+---
+description: 
+globs: 
+alwaysApply: false
+---
+# Project Structure Guide
+
+- Main entry: [src/main.tsx](mdc:src/main.tsx)
+- App component: [src/App.tsx](mdc:src/App.tsx)
+- Components: [src/components/](mdc:src/components)
+- Node logic: [src/nodes/](mdc:src/nodes)
+- Edge logic: [src/edges/](mdc:src/edges)
+- Styles: [src/index.css](mdc:src/index.css)
+- Types: [src/nodes/types.ts](mdc:src/nodes/types.ts)
+- Documentation: [docs/](mdc:docs)
+- Configuration: [package.json](mdc:package.json), [vite.config.ts](mdc:vite.config.ts), [tsconfig.json](mdc:tsconfig.json)
+- Entry HTML: [index.html](mdc:index.html)

orcheo-0.0.1/.devcontainer/Dockerfile

@@ -0,0 +1,5 @@
+FROM mcr.microsoft.com/devcontainers/python:3.12
+
+# Install uv for dependency management
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh \
+    && ln -s /root/.local/bin/uv /usr/local/bin/uv

orcheo-0.0.1/.devcontainer/devcontainer.json

@@ -0,0 +1,33 @@
+{
+  "name": "Orcheo",
+  "dockerFile": "Dockerfile",
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {
+      "version": "lts"
+    }
+  },
+  "forwardPorts": [8000, 8080],
+  "postCreateCommand": "uv sync --all-groups",
+  "remoteEnv": {
+    "UV_NO_SYNC": "1"
+  },
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "python.defaultInterpreterPath": "/usr/local/bin/python",
+        "python.formatting.provider": "none",
+        "editor.formatOnSave": true,
+        "editor.codeActionsOnSave": {
+          "source.organizeImports": "explicit",
+          "source.fixAll": "explicit"
+        }
+      },
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "charliermarsh.ruff",
+        "esbenp.prettier-vscode"
+      ]
+    }
+  }
+}

orcheo-0.0.1/.env.example

@@ -0,0 +1,14 @@
+# Default environment configuration for local development.
+# Copy this file to `.env` and adjust values as needed.
+ORCHEO_HOST=0.0.0.0
+ORCHEO_PORT=8000
+ORCHEO_CHECKPOINT_BACKEND=sqlite
+ORCHEO_SQLITE_PATH=.orcheo/orcheo.sqlite3
+
+# Credential vault configuration
+ORCHEO_VAULT_BACKEND=inmemory
+# ORCHEO_VAULT_ENCRYPTION_KEY=  # Required for file/aws_kms backends - use strong random key (32+ chars)
+# ORCHEO_VAULT_LOCAL_PATH=.orcheo/vault.sqlite
+# ORCHEO_VAULT_AWS_REGION=
+# ORCHEO_VAULT_AWS_KMS_KEY_ID=
+# ORCHEO_VAULT_TOKEN_TTL_SECONDS=3600  # Token expiration time in seconds

orcheo-0.0.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

orcheo-0.0.1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

orcheo-0.0.1/.github/workflows/after-ci.yml

@@ -0,0 +1,50 @@
+name: After CI
+
+on:
+  workflow_run:
+    workflows: [CI]
+    types: [completed]
+
+permissions:
+  statuses: write
+  pull-requests: write
+
+jobs:
+  smokeshow:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: '3.12'
+
+      - uses: dawidd6/action-download-artifact@v6
+        with:
+          workflow: ci.yml
+          name: '(diff-)?coverage-html.*'
+          name_is_regexp: true
+          commit: ${{ github.event.workflow_run.head_sha }}
+          allow_forks: true
+          workflow_conclusion: completed
+          if_no_artifact_found: warn
+
+      - run: uvx smokeshow upload coverage-html
+        if: hashFiles('coverage-html/*.html') != ''
+        env:
+          SMOKESHOW_GITHUB_STATUS_DESCRIPTION: Coverage {coverage-percentage}
+          SMOKESHOW_GITHUB_COVERAGE_THRESHOLD: 50
+          SMOKESHOW_GITHUB_CONTEXT: coverage
+          SMOKESHOW_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SMOKESHOW_GITHUB_PR_HEAD_SHA: ${{ github.event.workflow_run.head_sha }}
+          SMOKESHOW_AUTH_KEY: ${{ secrets.SMOKESHOW_AUTH_KEY }}
+
+      - run: uvx smokeshow upload diff-coverage-html
+        if: hashFiles('diff-coverage-html/*.html') != ''
+        env:
+          SMOKESHOW_GITHUB_STATUS_DESCRIPTION: Diff coverage {coverage-percentage}
+          SMOKESHOW_GITHUB_COVERAGE_THRESHOLD: 95
+          SMOKESHOW_GITHUB_CONTEXT: diff-coverage
+          SMOKESHOW_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SMOKESHOW_GITHUB_PR_HEAD_SHA: ${{ github.event.workflow_run.head_sha }}
+          SMOKESHOW_AUTH_KEY: ${{ secrets.SMOKESHOW_AUTH_KEY }}

orcheo-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,190 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'core-v*'
+      - 'backend-v*'
+      - 'sdk-v*'
+  pull_request:
+    branches:
+      - main
+    types:
+      - opened
+      - synchronize
+      - ready_for_review
+
+permissions:
+  id-token: write  # Required for PyPI trusted publishing
+  contents: read
+
+jobs:
+  lint:
+    if: github.event_name != 'pull_request' || github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Check style against standards
+        run: uv run make lint
+
+  coverage:
+    if: github.event_name != 'pull_request' || github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Run unit tests with coverage
+        run: |
+          uv run coverage run -m pytest
+          uv run coverage html --show-contexts --title "Coverage for ${{ github.sha }}"
+          uv run coverage xml
+          uv run diff-cover coverage.xml --html-report index.html
+
+      - name: Store coverage html
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-html
+          path: htmlcov
+          include-hidden-files: true
+
+      - name: Store diff coverage html
+        uses: actions/upload-artifact@v4
+        with:
+          name: diff-coverage-html
+          path: index.html
+
+      - name: Check coverage
+        run: |
+          uv run coverage report --fail-under 95
+          uv run diff-cover coverage.xml --fail-under 100
+
+  postgres-persistence:
+    if: github.event_name != 'pull_request' || github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: postgres
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Run Postgres persistence checks
+        env:
+          ORCHEO_POSTGRES_DSN: postgresql://postgres:postgres@localhost:5432/postgres
+          ORCHEO_CHECKPOINT_BACKEND: postgres
+        run: |
+          uv run pytest tests/integration/test_postgres_persistence.py -q
+
+  build-and-release:
+    needs: [lint, coverage, postgres-persistence]
+    if: "startsWith(github.ref, 'refs/tags/')"
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Determine package context
+        id: package
+        run: |
+          tag="${GITHUB_REF_NAME}"
+          if [[ "$tag" == core-v* ]]; then
+            echo "package=orcheo" >> "$GITHUB_OUTPUT"
+          elif [[ "$tag" == backend-v* ]]; then
+            echo "package=orcheo-backend" >> "$GITHUB_OUTPUT"
+          elif [[ "$tag" == sdk-v* ]]; then
+            echo "package=orcheo-sdk" >> "$GITHUB_OUTPUT"
+          else
+            echo "Unsupported tag prefix: $tag" >&2
+            exit 1
+          fi
+          echo "dist_dir=dist/${GITHUB_REF_NAME}" >> "$GITHUB_OUTPUT"
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Build ${{ steps.package.outputs.package }}
+        run: |
+          uv build --package "${{ steps.package.outputs.package }}" --out-dir "${{ steps.package.outputs.dist_dir }}"
+
+      - name: Publish ${{ steps.package.outputs.package }} to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: ${{ steps.package.outputs.dist_dir }}
+
+  canvas:
+    if: github.event_name != 'pull_request' || github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: apps/canvas
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - name: Install dependencies
+        run: npm install
+      - name: Lint
+        run: npm run lint
+      - name: Test
+        run: npm run test -- --run

orcheo-0.0.1/.github/workflows/claude.yml

@@ -0,0 +1,48 @@
+name: Claude PR Assistant
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude-code-action:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude PR Action
+        uses: anthropics/claude-code-action@beta
+        with:
+          # anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          # Or use OAuth token instead:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          timeout_minutes: "60"
+          # mode: tag  # Default: responds to @claude mentions
+          # Optional: Restrict network access to specific domains only
+          # experimental_allowed_domains: |
+          #   .anthropic.com
+          #   .github.com
+          #   api.github.com
+          #   .githubusercontent.com
+          #   bun.sh
+          #   registry.npmjs.org
+          #   .blob.core.windows.net

orcheo-0.0.1/.gitignore

@@ -0,0 +1,186 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+/lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+xunit-result.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Dependencies
+node_modules/
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Build
+dist/
+dist-ssr/
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# OS generated files
+.DS_Store
+**/.DS_Store
+
+# LangGraph
+checkpoints.sqlite

orcheo-0.0.1/.pre-commit-config.yaml

@@ -0,0 +1,26 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-case-conflict
+      - id: check-docstring-first
+      - id: check-builtin-literals
+      - id: check-ast
+      - id: check-merge-conflict
+
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: 'v0.4.6'
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks
+    rev: v2.13.0
+    hooks:
+      - id: pretty-format-toml
+        args: [--autofix]

orcheo-0.0.1/.python-version

@@ -0,0 +1 @@
+3.12.6