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

sinatra_dev-0.1.0/README.md → sinatra_dev-0.1.2/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.2
+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.2/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.2}/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.2"
+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

{sinatra_dev-0.1.0 → sinatra_dev-0.1.2}/src/sinatra_dev/_generated/api/tasks/tasks_create.py

@@ -122,9 +122,10 @@ def sync_detailed(
     Only `prompt` is required. `title` defaults to the prompt's first line, up to 80 characters. `repo`
     is optional: omit it to let the agent choose a repository.
 
-    Before it makes the task, Sinatra checks that the workspace is connected to GitHub, that billing
-    allows the task, and that the queue has room. A refusal says which in its `error` code, and a retry
-    with the same key of a start that already made its task is never refused.
+    Before it makes the task, Sinatra checks that the workspace is connected to GitHub when the start
+    names a repository (without GitHub a task that names none can still answer, research or plan), that
+    billing allows the task, and that the queue has room. A refusal says which in its `error` code, and
+    a retry with the same key of a start that already made its task is never refused.
 
     Send an `Idempotency-Key` so a retry is safe. A start retried with the same key returns the same
     task and never starts a second one. The same key with a different prompt, or a different repository
@@ -182,9 +183,10 @@ def sync(
     Only `prompt` is required. `title` defaults to the prompt's first line, up to 80 characters. `repo`
     is optional: omit it to let the agent choose a repository.
 
-    Before it makes the task, Sinatra checks that the workspace is connected to GitHub, that billing
-    allows the task, and that the queue has room. A refusal says which in its `error` code, and a retry
-    with the same key of a start that already made its task is never refused.
+    Before it makes the task, Sinatra checks that the workspace is connected to GitHub when the start
+    names a repository (without GitHub a task that names none can still answer, research or plan), that
+    billing allows the task, and that the queue has room. A refusal says which in its `error` code, and
+    a retry with the same key of a start that already made its task is never refused.
 
     Send an `Idempotency-Key` so a retry is safe. A start retried with the same key returns the same
     task and never starts a second one. The same key with a different prompt, or a different repository
@@ -237,9 +239,10 @@ async def asyncio_detailed(
     Only `prompt` is required. `title` defaults to the prompt's first line, up to 80 characters. `repo`
     is optional: omit it to let the agent choose a repository.
 
-    Before it makes the task, Sinatra checks that the workspace is connected to GitHub, that billing
-    allows the task, and that the queue has room. A refusal says which in its `error` code, and a retry
-    with the same key of a start that already made its task is never refused.
+    Before it makes the task, Sinatra checks that the workspace is connected to GitHub when the start
+    names a repository (without GitHub a task that names none can still answer, research or plan), that
+    billing allows the task, and that the queue has room. A refusal says which in its `error` code, and
+    a retry with the same key of a start that already made its task is never refused.
 
     Send an `Idempotency-Key` so a retry is safe. A start retried with the same key returns the same
     task and never starts a second one. The same key with a different prompt, or a different repository
@@ -295,9 +298,10 @@ async def asyncio(
     Only `prompt` is required. `title` defaults to the prompt's first line, up to 80 characters. `repo`
     is optional: omit it to let the agent choose a repository.
 
-    Before it makes the task, Sinatra checks that the workspace is connected to GitHub, that billing
-    allows the task, and that the queue has room. A refusal says which in its `error` code, and a retry
-    with the same key of a start that already made its task is never refused.
+    Before it makes the task, Sinatra checks that the workspace is connected to GitHub when the start
+    names a repository (without GitHub a task that names none can still answer, research or plan), that
+    billing allows the task, and that the queue has room. A refusal says which in its `error` code, and
+    a retry with the same key of a start that already made its task is never refused.
 
     Send an `Idempotency-Key` so a retry is safe. A start retried with the same key returns the same
     task and never starts a second one. The same key with a different prompt, or a different repository