[WEAVE] Migrate examples folder from old docs site (#1879)

## Description
This migrates working examples from the old Weave docs site to this one.
Scott C. and I will work on possibly properly reintegrating them into
the docs.

Author: dbrian57

weave/examples/.gitignore

@@ -0,0 +1,5 @@
+local_artifacts
+MNIST
+aclImdb
+aclImdb_v1.tar.gz
+wandb/

weave/examples/README.md

@@ -0,0 +1,28 @@
+# Weave Examples
+
+## Examples structure
+
+The `examples/` folder contains:
+
+- `get_started.ipynb`: a quick interactive notebook overview of Weave
+- `getting_started`: Learn how to build interactive data applications
+- `reference`: Syntax and usage for Weave types, ops, and panels
+- `monitoring`: Examples and documentation for LLM monitoring
+- `experimental`: Everything else, ranging from focused proofs-of-concept to very experimental works-in-progress—we hope these inspire your exploration and welcome PRs for improvement!
+- `apps`: Example applications
+- `guides (future)`: Guides to use specific features for advanced users
+
+## Running examples
+
+### Locally with Jupyter notebook
+
+Run `jupyter notebook` or `jupyter lab` in the root directory `examples`, and then use the Jupyter browser to find and open.
+
+### Google Colab
+
+Run the same code in a Google Colab, making sure to install Weave from PyPi first with `!pip install weave`.
+
+Colabs to get started:
+
+- [Weave Quickstart](https://colab.research.google.com/drive/1TwlhvvoWIHKDtRUu6eW0NMRq0GzGZ9oX)
+- [Weave Board Quickstart: Generative AI Playground](https://colab.research.google.com/drive/1gcR-ucIgjDbDEBFykEpJ3kkBoBQ84Ipr)

weave/examples/agents/explorer.py

@@ -0,0 +1,82 @@
+import json
+import subprocess
+
+import weave
+from weave.agent.agent import Agent, AgentState
+
+SYSTEM_MESSAGE = """Assistant is an automonmous agent.
+Agent likes to explore it's world, using any means necessary.
+Agent never stops exploring, it is completely autonomous.
+Agent documents its learnings in a file call "journal.txt".
+"""
+
+LENGTH_LIMIT = 1000
+
+
+@weave.op
+def run_command(command: str) -> str:
+    """Run a shell command and return its output.
+
+    Args:
+        command: The command to run.
+
+    Returns:
+        The output of the command.
+    """
+    try:
+        completed_process = subprocess.run(
+            command,
+            capture_output=True,
+            text=True,
+            shell=True,
+        )
+        exit_code = completed_process.returncode
+        stdout = completed_process.stdout.strip()
+        stderr = completed_process.stderr.strip()
+    except Exception as e:
+        exit_code = -1
+        stdout = ""
+        stderr = str(e)
+
+    if len(stdout) > LENGTH_LIMIT:
+        stdout = stdout[:LENGTH_LIMIT]
+        stdout += "\n... (truncated)"
+    if len(stderr) > LENGTH_LIMIT:
+        stderr = stderr[:LENGTH_LIMIT]
+        stderr += "\n... (truncated)"
+
+    return json.dumps({"exit_code": exit_code, "stdout": stdout, "stderr": stderr})
+
+
+if __name__ == "__main__":
+    # weave.init("wf-explorer1")
+
+    agent = Agent(
+        model_name="gpt-4-0125-preview",
+        system_message=SYSTEM_MESSAGE,
+        tools=[run_command],
+    )
+
+    state = AgentState(
+        history=[
+            {
+                "role": "user",
+                "content": "Explore everything you can find, using your tools. You are completely autonomous, so don't stop to ask for input, just keep exploring.",
+            },
+        ]
+    )
+
+    while True:
+        state = agent.step(state)
+        last_message = state.history[-1]
+        if last_message["role"] == "assistant" and "tool_calls" not in last_message:
+            user_input = input("User input: ")
+            state = AgentState(
+                history=state.history
+                + [
+                    {
+                        "role": "user",
+                        "content": user_input,
+                    }
+                ]
+            )

weave/examples/agents/programmer.py

@@ -0,0 +1,179 @@
+import subprocess
+import sys
+
+from rich import print
+from rich.console import Console
+
+import weave
+from weave.agent.agent import Agent, AgentState
+
+WELCOME = """
+Welcome to programmer.
+
+What would you like to do?
+
+"""
+
+SYSTEM_MESSAGE = """Assistant is a programming assistant named "programmer".
+programmer is fairly autonomous, and tries to proceed on its own to solve problems.
+programmer always has access to a shell and local filesystem in perform tasks, via the run_command tool.
+programmer is managed by the user. The user will provide guidance and feedback.
+programmer's goal is contained in the spec.txt file.
+programmer writes files using the provided tools.
+"""
+
+console = Console()
+
+import json
+import os
+
+LENGTH_LIMIT = 1000
+
+
+@weave.op
+def list_files(directory: str) -> str:
+    """List names of all files in a directory.
+
+    Args:
+        directory: The directory to list.
+
+    Returns:
+        The list of files in the directory.
+    """
+    try:
+        result = json.dumps(os.listdir(directory))
+        if len(result) > LENGTH_LIMIT:
+            result = result[:LENGTH_LIMIT]
+            result += "\n... (truncated)"
+    except Exception as e:
+        return json.dumps([str(e)])
+    else:
+        return result
+
+
+@weave.op
+def write_to_file(path: str, content: str) -> str:
+    """Write text to a file at the tiven path.
+
+    Args:
+        path: The path to the file.
+        content: The content to write to the file.
+
+    Returns:
+        A message indicating whether the file was written successfully.
+    """
+    try:
+        with open(path, "w") as f:
+            f.write(content)
+    except Exception as e:
+        return str(e)
+    else:
+        return "File written successfully."
+
+
+@weave.op
+def read_from_file(path: str) -> str:
+    """Read text from a file at the given path.
+
+    Args:
+        path: The path to the file.
+
+    Returns:
+        The content of the file.
+    """
+    try:
+        with open(path) as f:
+            result = f.read()
+            if len(result) > LENGTH_LIMIT:
+                result = result[:LENGTH_LIMIT]
+                result += "\n... (truncated)"
+            return result
+    except Exception as e:
+        return str(e)
+
+
+@weave.op
+def run_command(command: str) -> str:
+    """Run a shell command and return its output.
+
+    Args:
+        command: The command to run.
+
+    Returns:
+        The output of the command.
+    """
+    try:
+        completed_process = subprocess.run(
+            command,
+            capture_output=True,
+            text=True,
+            shell=True,
+        )
+        exit_code = completed_process.returncode
+        stdout = completed_process.stdout.strip()
+        stderr = completed_process.stderr.strip()
+    except Exception as e:
+        exit_code = -1
+        stdout = ""
+        stderr = str(e)
+
+    if len(stdout) > LENGTH_LIMIT:
+        stdout = stdout[:LENGTH_LIMIT]
+        stdout += "\n... (truncated)"
+    if len(stderr) > LENGTH_LIMIT:
+        stderr = stderr[:LENGTH_LIMIT]
+        stderr += "\n... (truncated)"
+
+    result = f"Exit code: {exit_code}\n"
+    if stderr:
+        result += f"STDERR\n{stderr}\n"
+    if stdout:
+        result += f"STDOUT\n{stdout}\n"
+    return result
+
+
+@weave.op
+def run(state: AgentState):
+    while True:
+        state = agent.step(state)
+        last_message = state.history[-1]
+        if last_message["role"] == "assistant" and "tool_calls" not in last_message:
+            user_input = input("User input: ")
+            state = AgentState(
+                history=state.history
+                + [
+                    {
+                        "role": "user",
+                        "content": user_input,
+                    }
+                ]
+            )
+
+
+if __name__ == "__main__":
+    weave.init("wfchobj-programmer2")
+    console.rule("[bold blue]Programmer")
+    console.print(WELCOME)
+
+    agent = Agent(
+        model_name="gpt-4-0125-preview",
+        system_message=SYSTEM_MESSAGE,
+        tools=[list_files, write_to_file, read_from_file, run_command],
+    )
+
+    if len(sys.argv) < 2:
+        initial_prompt = input("Initial prompt: ")
+    else:
+        initial_prompt = " ".join(sys.argv[1:])
+        print("Initial prompt:", initial_prompt)
+
+    state = AgentState(
+        history=[
+            {
+                "role": "user",
+                "content": initial_prompt,
+            },
+        ]
+    )
+
+    run(state)