sinatra-dev 0.1.0__tar.gz → 0.1.1__tar.gz

sinatra_dev-0.1.0/README.md → sinatra_dev-0.1.1/PKG-INFO

@@ -1,8 +1,38 @@
-# sinatra-dev
-
-A Python client for the [Sinatra API](https://docs.sinatra.dev/docs/api-reference): start, follow and stop Sinatra tasks, and delegate Linear and GitHub issues.
-
-It runs on Python 3.11 and later, is typed (`py.typed`), and depends only on `httpx` and `attrs`. The client is generated from the API's [OpenAPI spec](https://api.sinatra.dev/openapi.json) and released automatically when the spec changes.
+Metadata-Version: 2.5
+Name: sinatra-dev
+Version: 0.1.1
+Summary: Official Python client for sinatra.dev, the AI coding agent that turns Linear and GitHub issues into pull requests: start, follow and stop tasks, and delegate issues.
+Project-URL: Homepage, https://www.sinatra.dev
+Project-URL: Documentation, https://docs.sinatra.dev/docs/api-reference
+Project-URL: Repository, https://github.com/sinatra-dev/sinatra-python
+Project-URL: Issues, https://github.com/sinatra-dev/sinatra-python/issues
+Author-email: Sinatra <contact@sinatra.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-coding-agent,api-client,automation,background-agent,coding-agent,github,linear,pull-request,sdk,sinatra,sinatra.dev
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: attrs>=22.2.0
+Requires-Dist: httpx<0.29.0,>=0.23.1
+Description-Content-Type: text/markdown
+
+# Sinatra Python SDK
+
+`sinatra-dev` is the official Python client for [sinatra.dev](https://www.sinatra.dev), the hosted AI coding agent that turns Linear and GitHub issues into pull requests. Assign Sinatra an issue, mention it in Slack, or start a task from code, and it writes the change in its own sandbox and opens a draft pull request for your team to review.
+
+With this client you can start, follow and stop Sinatra tasks and delegate Linear and GitHub issues from your own scripts, CI jobs and tools, through the [Sinatra API](https://docs.sinatra.dev/docs/api-reference).
+
+It runs on Python 3.11 and later, is typed (`py.typed`), and depends only on `httpx` and `attrs`. The client is generated from the API's [OpenAPI spec](https://api.sinatra.dev/openapi.json) and released automatically when the spec changes. There are also official SDKs for [Node.js / TypeScript](https://github.com/sinatra-dev/sinatra-node) and [Go](https://github.com/sinatra-dev/sinatra-go); see [SDKs](https://docs.sinatra.dev/docs/sdks).
 
 ## Install
 
@@ -44,6 +74,20 @@ with Sinatra() as sinatra:  # reads SINATRA_TOKEN
 
 The API has no streaming. To wait for a reply, read the conversation after the last entry you've seen, and check the task's `status`: the agent posts one reply per turn, and the turn is done when the task stops working. The loop reads the status before the conversation, so it never stops before printing the reply that ended the turn. An unknown status counts as done, so the loop can't wait forever on a status added after this was written. See [How replies work](https://docs.sinatra.dev/docs/cli-and-api#how-replies-work).
 
+## Examples
+
+[`examples/`](https://github.com/sinatra-dev/sinatra-python/tree/main/examples) has small programs you can run as they are:
+
+- [`delegate_issue.py`](https://github.com/sinatra-dev/sinatra-python/blob/main/examples/delegate_issue.py): hand Sinatra a Linear issue (`ENG-123`) or a GitHub issue (`acme/web#42`), for example from a CI job.
+- [`search_issues.py`](https://github.com/sinatra-dev/sinatra-python/blob/main/examples/search_issues.py): list the open issues you could delegate, yours first.
+- [`open_prs.py`](https://github.com/sinatra-dev/sinatra-python/blob/main/examples/open_prs.py): print the pull requests Sinatra has open in each workspace as a Markdown list, for a standup or a Slack post.
+
+With the package installed (`pip install sinatra-dev`), or from a checkout with `uv run`:
+
+```sh
+SINATRA_TOKEN=sntr_... uv run python examples/open_prs.py
+```
+
 ## Authentication
 
 Create a personal access token on the [Access tokens](https://app.sinatra.dev/tokens) page (**CLI & API** in the dashboard). It starts with `sntr_` and acts as you in every workspace you belong to. The client reads it from the `SINATRA_TOKEN` environment variable, or you can pass it:

sinatra_dev-0.1.0/PKG-INFO → sinatra_dev-0.1.1/README.md

@@ -1,34 +1,10 @@
-Metadata-Version: 2.5
-Name: sinatra-dev
-Version: 0.1.0
-Summary: Python client for the Sinatra API: start, follow and stop Sinatra tasks, and delegate Linear and GitHub issues.
-Project-URL: Homepage, https://sinatra.dev
-Project-URL: Documentation, https://docs.sinatra.dev/docs/api-reference
-Project-URL: Repository, https://github.com/sinatra-dev/sinatra-python
-Project-URL: Issues, https://github.com/sinatra-dev/sinatra-python/issues
-Author-email: Sinatra <contact@sinatra.dev>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: api-client,coding-agent,sdk,sinatra,sinatra.dev
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-Requires-Dist: attrs>=22.2.0
-Requires-Dist: httpx<0.29.0,>=0.23.1
-Description-Content-Type: text/markdown
-
-# sinatra-dev
-
-A Python client for the [Sinatra API](https://docs.sinatra.dev/docs/api-reference): start, follow and stop Sinatra tasks, and delegate Linear and GitHub issues.
-
-It runs on Python 3.11 and later, is typed (`py.typed`), and depends only on `httpx` and `attrs`. The client is generated from the API's [OpenAPI spec](https://api.sinatra.dev/openapi.json) and released automatically when the spec changes.
+# Sinatra Python SDK
+
+`sinatra-dev` is the official Python client for [sinatra.dev](https://www.sinatra.dev), the hosted AI coding agent that turns Linear and GitHub issues into pull requests. Assign Sinatra an issue, mention it in Slack, or start a task from code, and it writes the change in its own sandbox and opens a draft pull request for your team to review.
+
+With this client you can start, follow and stop Sinatra tasks and delegate Linear and GitHub issues from your own scripts, CI jobs and tools, through the [Sinatra API](https://docs.sinatra.dev/docs/api-reference).
+
+It runs on Python 3.11 and later, is typed (`py.typed`), and depends only on `httpx` and `attrs`. The client is generated from the API's [OpenAPI spec](https://api.sinatra.dev/openapi.json) and released automatically when the spec changes. There are also official SDKs for [Node.js / TypeScript](https://github.com/sinatra-dev/sinatra-node) and [Go](https://github.com/sinatra-dev/sinatra-go); see [SDKs](https://docs.sinatra.dev/docs/sdks).
 
 ## Install
 
@@ -70,6 +46,20 @@ with Sinatra() as sinatra:  # reads SINATRA_TOKEN
 
 The API has no streaming. To wait for a reply, read the conversation after the last entry you've seen, and check the task's `status`: the agent posts one reply per turn, and the turn is done when the task stops working. The loop reads the status before the conversation, so it never stops before printing the reply that ended the turn. An unknown status counts as done, so the loop can't wait forever on a status added after this was written. See [How replies work](https://docs.sinatra.dev/docs/cli-and-api#how-replies-work).
 
+## Examples
+
+[`examples/`](https://github.com/sinatra-dev/sinatra-python/tree/main/examples) has small programs you can run as they are:
+
+- [`delegate_issue.py`](https://github.com/sinatra-dev/sinatra-python/blob/main/examples/delegate_issue.py): hand Sinatra a Linear issue (`ENG-123`) or a GitHub issue (`acme/web#42`), for example from a CI job.
+- [`search_issues.py`](https://github.com/sinatra-dev/sinatra-python/blob/main/examples/search_issues.py): list the open issues you could delegate, yours first.
+- [`open_prs.py`](https://github.com/sinatra-dev/sinatra-python/blob/main/examples/open_prs.py): print the pull requests Sinatra has open in each workspace as a Markdown list, for a standup or a Slack post.
+
+With the package installed (`pip install sinatra-dev`), or from a checkout with `uv run`:
+
+```sh
+SINATRA_TOKEN=sntr_... uv run python examples/open_prs.py
+```
+
 ## Authentication
 
 Create a personal access token on the [Access tokens](https://app.sinatra.dev/tokens) page (**CLI & API** in the dashboard). It starts with `sntr_` and acts as you in every workspace you belong to. The client reads it from the `SINATRA_TOKEN` environment variable, or you can pass it:

{sinatra_dev-0.1.0 → sinatra_dev-0.1.1}/pyproject.toml

@@ -1,16 +1,30 @@
 [project]
 name = "sinatra-dev"
-version = "0.1.0"
-description = "Python client for the Sinatra API: start, follow and stop Sinatra tasks, and delegate Linear and GitHub issues."
+version = "0.1.1"
+description = "Official Python client for sinatra.dev, the AI coding agent that turns Linear and GitHub issues into pull requests: start, follow and stop tasks, and delegate issues."
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE"]
 requires-python = ">=3.11"
 authors = [{ name = "Sinatra", email = "contact@sinatra.dev" }]
-keywords = ["sinatra", "sinatra.dev", "sdk", "api-client", "coding-agent"]
+keywords = [
+    "sinatra",
+    "sinatra.dev",
+    "sdk",
+    "api-client",
+    "coding-agent",
+    "ai-coding-agent",
+    "background-agent",
+    "linear",
+    "github",
+    "pull-request",
+    "automation",
+]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries :: Python Modules",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3.11",
@@ -27,7 +41,7 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://sinatra.dev"
+Homepage = "https://www.sinatra.dev"
 Documentation = "https://docs.sinatra.dev/docs/api-reference"
 Repository = "https://github.com/sinatra-dev/sinatra-python"
 Issues = "https://github.com/sinatra-dev/sinatra-python/issues"
@@ -68,7 +82,7 @@ select = ["E", "F", "W", "I", "B", "UP", "SIM", "RUF"]
 [tool.mypy]
 python_version = "3.11"
 strict = true
-files = ["src/sinatra_dev", "tests"]
+files = ["src/sinatra_dev", "tests", "examples"]
 
 # The generated httpx Client/AuthenticatedClient wrappers don't pass strict
 # mypy, and the wrapper never uses them (it sends requests itself). The rest