first commit

.gitignore

@@ -0,0 +1,20 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.env
+.venv/
+venv/
+*.egg-info/
+*.egg
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+eval_data/baselines.json
+schemashift-grpo-*/
+wandb/
+.ipynb_checkpoints/
+.DS_Store
+Thumbs.db
+*.log
+insurance_video/*.mp4

Dockerfile

@@ -0,0 +1,3 @@
+# Placeholder — will be filled in Phase 7.
+# Target base: ghcr.io/meta-pytorch/openenv-base:latest
+# Expose port 7860 for HF Spaces Docker SDK.

README.md

@@ -0,0 +1,12 @@
+# SchemaShift — OpenEnv Hackathon Round 2
+
+RL environment where a workflow agent completes multi-step SaaS admin tasks across tools (Mail, Calendar, CRM, + stretch: Chat, Docs) while tool APIs drift mid-episode. Trains adaptive tool use — a meta-skill frontier LLMs lack.
+
+**Team Tripod:** Yashash Sheshagiri (lead), Gajanand V Dhayagode, Likith B S
+**Event:** Meta × Hugging Face × PyTorch Hackathon 2026 · April 25–26, 2026 · Bangalore
+**Themes:** Multi-Agent · Long-Horizon · World Modeling
+**Sub-themes:** Patronus (Schema Drift) · Scaler (Multi-App Enterprise)
+
+## Status
+
+Scaffolding (Phase 0). See `SchemaShift_Phase_Plan.md` for build phases.

__init__.py

@@ -0,0 +1,3 @@
+"""SchemaShift — OpenEnv RL environment for adaptive tool use under API drift."""
+
+__version__ = "0.1.0"

client.py

@@ -0,0 +1,4 @@
+"""SchemaShiftEnvClient — HTTP client for TRL GRPO training loop.
+
+Will be filled in Phase 8.
+"""

drift.py

@@ -0,0 +1,4 @@
+"""DriftInjector — fires scheduled drift events against tools mid-episode.
+
+Will be filled in Phase 3.
+"""

eval.py

@@ -0,0 +1,4 @@
+"""Baseline eval harness for heuristic + LLM agents.
+
+Will be filled in Phase 9.
+"""

eval_data/seeds.json

@@ -0,0 +1 @@
+{}

graders.py

@@ -0,0 +1,4 @@
+"""Composable rubric grader + dense step-level reward shaping.
+
+Will be filled in Phase 5.
+"""

models.py

@@ -0,0 +1,4 @@
+"""Pydantic schemas for SchemaShift actions, observations, and rewards.
+
+Will be filled in Phase 1.
+"""

openenv.yaml

@@ -0,0 +1,7 @@
+# Placeholder — will be filled in Phase 7.
+# spec_version: 1
+# name: schemashift
+# type: space
+# runtime: fastapi
+# app: server.app:app
+# port: 7860

pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "schemashift"
+version = "0.1.0"
+description = "OpenEnv RL environment for adaptive tool use under API schema drift."
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "Yashash Sheshagiri" },
+    { name = "Gajanand V Dhayagode" },
+    { name = "Likith B S" },
+]
+license = { text = "Apache-2.0" }
+dependencies = [
+    "fastapi>=0.110",
+    "uvicorn>=0.27",
+    "pydantic>=2.6",
+    "httpx>=0.27",
+    "python-dotenv>=1.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0"]
+ui = ["gradio>=4.20"]
+eval = ["openai>=1.30"]
+
+[tool.setuptools]
+packages = ["schemashift", "schemashift.tools", "schemashift.server", "schemashift.training"]
+package-dir = {"schemashift" = "."}
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]

requirements.txt

@@ -0,0 +1,9 @@
+openenv-core==0.2.3
+fastapi>=0.110
+uvicorn>=0.27
+pydantic>=2.6
+gradio>=4.20
+openai>=1.30
+httpx>=0.27
+python-dotenv>=1.0
+pytest>=8.0

scenarios.py

@@ -0,0 +1,4 @@
+"""Scenario definitions (E1-E3 easy, M1-M3 medium, H1-H3 hard).
+
+Will be filled in Phase 4 (easy) and Phase 11 (medium+).
+"""

server/app.py

@@ -0,0 +1,4 @@
+"""FastAPI server + Gradio replay UI. Exposes /health, /reset, /step, /state, /tasks, /grader.
+
+Will be filled in Phase 7.
+"""

server/environment.py

@@ -0,0 +1,4 @@
+"""SchemaShiftEnvironment — episode scheduler. reset/step loop with drift ticks + grader.
+
+Will be filled in Phase 6.
+"""

tools/base.py

@@ -0,0 +1,4 @@
+"""BaseTool + EndpointSchema — abstract contract for all SaaS tool APIs.
+
+Will be filled in Phase 2.
+"""

tools/calendar.py

@@ -0,0 +1,4 @@
+"""CalendarAPI — list_events, create_event, update_event, delete_event + drifts.
+
+Will be filled in Phase 3.
+"""

tools/chat.py

@@ -0,0 +1,4 @@
+"""ChatAPI (stretch) — list_channels, post_message, get_history + drifts.
+
+Will be filled in Phase 10 stretch (only if Thursday checkpoint passes).
+"""

tools/crm.py

@@ -0,0 +1,4 @@
+"""CRMAPI — search_contacts, get_contact, create_contact, update_contact + drifts.
+
+Will be filled in Phase 4.
+"""

tools/docs.py

@@ -0,0 +1,4 @@
+"""DocsAPI (stretch) — create_page, get_page, update_page + drifts.
+
+Will be filled in Phase 10 stretch (only if Sunday onsite, everything else solid).
+"""

tools/mail.py

@@ -0,0 +1,4 @@
+"""MailAPI — list_messages, send_message, get_message + 3 drift handlers.
+
+Will be filled in Phase 2.
+"""

training/grpo_kaggle.ipynb

@@ -0,0 +1,26 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# SchemaShift GRPO Training (Kaggle T4) — Placeholder\n",
+    "\n",
+    "Will be filled in Phase 8."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

training/grpo_smoke.py

@@ -0,0 +1,4 @@
+"""5-step smoke test of GRPO loop against local env. Uses dummy reward.
+
+Will be filled in Phase 8.
+"""

training/train.py

@@ -0,0 +1,4 @@
+"""Standalone GRPO training script (mirrors the Kaggle notebook for CLI runs).
+
+Will be filled in Phase 8.
+"""