Quickstart (Python reference)

git clone https://github.com/Coder-s-OG-s/Trajectory-IR.git
cd Trajectory-IR
python -m venv .venv
# Windows: .\.venv\Scripts\activate
# Unix: source .venv/bin/activate
pip install -U pip
pip install -e ".[dev]"
pytest conformance/ -q

from client.python.trajectory_client import (
    open_trajectory,
    project,
    seal_decision,
    exec_tool,
    commit_step,
)
from trajectory_ir.effects import EffectClass
from trajectory_ir.runtime.tool import Tool

def echo(msg: str) -> str:
    return msg

traj = open_trajectory(tenant_id="demo", trajectory_id="qs-1", db_path="qs.sqlite")
project(traj, step_n=1, context={"goal": "hello"})
seal_decision(traj, step_n=1, plan={"tool_calls": [{"name": "echo", "args": {"msg": "hi"}}]})
tool = Tool(name="echo", fn=echo, effect_class=EffectClass.PURE)
result = exec_tool(traj, step_n=1, call={"args": {"msg": "hi"}}, tool=tool, seq=2)
print(result.result)  # hi
commit_step(traj, step_n=1, seq=4)