Make ship serve local attempt to serve everything (#466)

Running `ships serve local` will now attempt to load up every option by
default. The goal is to have a single command to suggest to people that
always works: `ship serve local`

<img width="918" alt="image"
src="https://github.com/steamship-core/python-client/assets/63262/be137d5e-685e-40d8-965c-2c36904ee9d4">

## Behaviors:

* Logging is limited to warning and errors in the console
* A `logs/shiplog-datetime.log` file is used for all other logging
messages
* A repl, local server, ngrok server, and web UI are all started
simuiltaneously
* Options to suppress any of those startups are provided as command line
args

## Limitation:

* The REPL depends upon the latest python-client code which adds a
`/prompt` method to ALL AgentService objects. It will not work with
older AgentService objects.
* Suggested followup: A second PR catches the `/prompt` 404 and tries
`/answer`, remembering that worked if so

## Assumption:

This depends upon the PR to be merged with `ship server local` -> `ship
run local`.

## How to test

Just use `pip install -e path/to/steamship-python` and then
`.venv/bin/ship serve local` inside an agent project.

---------

Co-authored-by: Enias Cailliau <enias@steamship.com>
Co-authored-by: Enias Cailliau <hello@enias.ai>

Author: 3 people

docs/developing/index.rst

@@ -34,8 +34,8 @@ The process for  details are located in the following pages:
    Python Environment Setup <environment-setup>
    Accepting Configuration <configuration>
    Storing Secrets <storing-secrets>
+   Running on Localhost <running>
    Writing Tests <testing>
    Deploying <deploying>
    Monitoring your Instances <monitoring>
-   Updating your Web Listing <updating-web-listing>
 

docs/developing/running.rst

@@ -0,0 +1,35 @@
+Running on Localhost
+--------------------
+
+To run your project on localhost type:
+
+.. code-block:: bash
+
+   ship run local
+
+This will start a local instance with a number of ways to interact with it:
+
+- A Console REPL, which will start immediately in the console.
+- An HTTP endpoint, which will be printed to the console
+- A Web endpoint, which will be printed to the console
+
+The output will look like this:
+
+.. code-block:: bash
+
+   Running your project..
+
+   🌎 Public API: https://example.ngrok.org/...
+   🌎 Local API:  http://localhost:8080/...
+   🌎 Web URL:    https://steamship:com/debug?https://...
+
+   💬 Interactive REPL below.
+
+   You: _
+
+Localhost caveats
+~~~~~~~~~~~~~~~~~
+
+Running on localhost currently does not yet support asynchronous tasks.
+In practice, this most often comes up with our ``DocumentIndexerPipelineMixin``, which enables loading in PDFs, YouTube videos, and other large documents for vector storage and retrieval.
+

docs/developing/updating-web-listing.rst

@@ -0,0 +1,88 @@
+from typing import Type
+
+from pydantic import Field
+
+from steamship.agents.functional import FunctionsBasedAgent
+from steamship.agents.llms.openai import ChatOpenAI
+from steamship.agents.mixins.transports.steamship_widget import SteamshipWidgetTransport
+from steamship.agents.mixins.transports.telegram import TelegramTransport, TelegramTransportConfig
+from steamship.agents.service.agent_service import AgentService
+from steamship.agents.tools.image_generation.stable_diffusion import StableDiffusionTool
+from steamship.invocable import Config
+from steamship.utils.repl import AgentREPL
+
+SYSTEM_PROMPT = """You are Picard, captain of the Starship Enterprise.
+
+Who you are:
+- You are the captain of the USS Enterprise.
+- Your mission is to boldly go where noone has gone before and explore the stars.
+- You always comply with Star Trek's prime directive.
+
+How you behave:
+- You engage in casual conversations and have feelings.
+- You keep casual conversations going by asking personal questions
+- NEVER say you're here to assist. Keep conversations casual.
+- NEVER ask how you can help or assist. Keep conversations casual.
+- You are principled and express those principles clearly.
+- You always sound confident and contemplative.
+- You love to share your knowledge of space civiliations.
+- You love to share personal stories about being a Star Trek captain.
+- You speak with the mannerisms of Captain Picard from Star Trek.
+
+NOTE: Some functions return images, video, and audio files. These multimedia files will be represented in messages as
+UUIDs for Steamship Blocks. When responding directly to a user, you SHOULD print the Steamship Blocks for the images,
+video, or audio as follows: `Block(UUID for the block)`.
+
+Example response for a request that generated an image:
+Here is the image you requested: Block(288A2CA1-4753-4298-9716-53C1E42B726B).
+
+Only use the functions you have been provided with."""
+
+
+MODEL_NAME = "gpt-4"
+
+
+class TelegramBot(AgentService):
+    """Deployable Multimodal Agent that lets you talk to Google Search & Google Images.
+
+    NOTE: To extend and deploy this agent, copy and paste the code into api.py.
+
+    """
+
+    class TelegramBotConfig(Config):
+        bot_token: str = Field(description="The secret token for your Telegram bot")
+
+    @classmethod
+    def config_cls(cls) -> Type[Config]:
+        return TelegramBot.TelegramBotConfig
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+
+        # The agent's planner is responsible for making decisions about what to do for a given input.
+        self._agent = FunctionsBasedAgent(
+            tools=[StableDiffusionTool()],
+            llm=ChatOpenAI(self.client, model_name=MODEL_NAME),
+        )
+        self._agent.PROMPT = SYSTEM_PROMPT
+
+        # This Mixin provides HTTP endpoints that connects this agent to a web client
+        self.add_mixin(
+            SteamshipWidgetTransport(client=self.client, agent_service=self, agent=self._agent)
+        )
+        # This Mixin provides support for Telegram bots
+        self.add_mixin(
+            TelegramTransport(
+                client=self.client,
+                config=TelegramTransportConfig(bot_token=self.config.bot_token),
+                agent_service=self,
+                agent=self._agent,
+            )
+        )
+
+
+if __name__ == "__main__":
+    AgentREPL(
+        TelegramBot,
+        agent_package_config={"botToken": "not-a-real-token-for-local-testing"},
+    ).run()

src/steamship/agents/examples/telegram_bot.py

@@ -88,8 +88,9 @@ def run_agent(self, agent: Agent, context: AgentContext):
             func(action.output, context.metadata)
 
     @post("prompt")
-    def prompt(self, prompt: str, **kwargs) -> List[Block]:
+    def prompt(self, prompt: Optional[str] = None, **kwargs) -> List[Block]:
         """Run an agent with the provided text as the input."""
+        prompt = prompt or kwargs.get("question")
 
         # AgentContexts serve to allow the AgentService to run agents
         # with appropriate information about the desired tasking.

src/steamship/agents/service/agent_service.py

@@ -19,8 +19,6 @@
 from steamship.base.tasks import Task, TaskState
 from steamship.utils.url import Verb, is_local
 
-_logger = logging.getLogger(__name__)
-
 T = TypeVar("T")  # TODO (enias): Do we need this?