@wenathlan/saddle 1.8.12 → 1.8.13

package/docs/repo-synthesis-1.8.21.md

@@ -0,0 +1,112 @@
+# Comparative synthesis for Saddle 1.8.21
+
+The evidence set contains 60 public repositories selected across browser, scraping, storage, workflow, extension and packaging categories. Metadata, README excerpts, relevant tree paths and up to two code excerpts per repository were collected through the GitHub API. This document records patterns, not copied code.
+
+## Evidence coverage
+
+| Measure | Result |
+|---|---:|
+| Repositories analyzed | 60 |
+| Repositories with code samples | 35 |
+| Code samples captured | 64 |
+| Repositories with relevant paths | 54 |
+
+## Category coverage
+
+| Category | Repositories |
+|---|---:|
+| browser automation | 14 |
+| web scraping crawler | 11 |
+| s3 compatible storage | 11 |
+| browser extension automation | 10 |
+| package release artifacts | 7 |
+| workflow engine ci cd | 5 |
+| storage backup | 1 |
+| storage | 1 |
+
+## License and language signals
+
+The license field is evidence for comparison, not permission to copy. Any code reuse would require a separate compatibility review against GPL-3.0-only and the repository's complete notices.
+
+| License signal | Repositories |
+|---|---:|
+| unknown | 19 |
+| MIT | 16 |
+| Apache-2.0 | 13 |
+| AGPL-3.0 | 5 |
+| NOASSERTION | 3 |
+| GPL-2.0 | 1 |
+| WTFPL | 1 |
+| BSD-3-Clause | 1 |
+| BSD-2-Clause | 1 |
+
+| Language | Repositories |
+|---|---:|
+| Python | 15 |
+| TypeScript | 12 |
+| JavaScript | 8 |
+| Go | 8 |
+| unknown | 4 |
+| C++ | 3 |
+| Jupyter Notebook | 2 |
+| Rust | 1 |
+| Java | 1 |
+| PHP | 1 |
+| Zig | 1 |
+| Dockerfile | 1 |
+
+## Recurring implementation signals
+
+| Signal | Repositories with evidence |
+|---|---:|
+| queue | 22 |
+| storage | 43 |
+| browser | 33 |
+| workflow | 39 |
+| release | 49 |
+| security | 27 |
+
+## Most visible repositories in the evidence set
+
+| Repository | Stars | License | Categories |
+|---|---:|---|---|
+| [n8n-io/n8n](https://github.com/n8n-io/n8n) | 200533 | NOASSERTION | workflow engine ci cd |
+| [browser-use/browser-use](https://github.com/browser-use/browser-use) | 109121 | MIT | browser automation |
+| [puppeteer/puppeteer](https://github.com/puppeteer/puppeteer) | 95460 | Apache-2.0 | browser automation |
+| [microsoft/playwright](https://github.com/microsoft/playwright) | 94485 | Apache-2.0 | browser automation |
+| [scrapy/scrapy](https://github.com/scrapy/scrapy) | 63841 | BSD-3-Clause | web scraping crawler |
+| [minio/minio](https://github.com/minio/minio) | 61393 | AGPL-3.0 | s3 compatible storage |
+| [rclone/rclone](https://github.com/rclone/rclone) | 59129 | MIT | storage |
+| [apache/airflow](https://github.com/apache/airflow) | 46473 | Apache-2.0 | workflow engine ci cd |
+| [vercel-labs/agent-browser](https://github.com/vercel-labs/agent-browser) | 40571 | Apache-2.0 | browser automation |
+| [restic/restic](https://github.com/restic/restic) | 35497 | BSD-2-Clause | storage backup |
+| [SeleniumHQ/selenium](https://github.com/SeleniumHQ/selenium) | 34368 | Apache-2.0 | browser automation |
+| [apify/crawlee](https://github.com/apify/crawlee) | 25378 | Apache-2.0 | web scraping crawler |
+| [browserbase/stagehand](https://github.com/browserbase/stagehand) | 23931 | MIT | browser automation |
+| [prefecthq/prefect](https://github.com/prefecthq/prefect) | 23618 | Apache-2.0 | workflow engine ci cd |
+| [renovatebot/renovate](https://github.com/renovatebot/renovate) | 22257 | AGPL-3.0 | package release artifacts |
+
+## Objective-driven candidate gaps for 1.8.21
+
+The comparison suggests five independent feature directions. They are selected because they fit observed Saddle contracts and can be implemented without importing a provider's code or binding the library to hosted infrastructure.
+
+| Candidate | Comparable pattern | Saddle implementation boundary | Decision |
+|---|---|---|---|
+| Durable request leases | Crawlee and workflow engines make queue ownership, retries and persistence explicit. | Extend the existing persistent queue with caller-owned lease, visibility timeout, attempt count and idempotency key; keep storage adapters injectable. | Select for implementation |
+| Structured extraction contract | Stagehand and Crawlee separate observation/extraction from action execution. | Add schema-neutral extraction results with provenance, bounded payload size and injected parser; do not add an LLM or hosted browser dependency. | Select for implementation |
+| Browser context budget | Stagehand emphasizes token-efficient context and deterministic locators. | Add bounded snapshot projection with field allowlist, max bytes and stable element references, reusing existing snapshot/diff contracts. | Select for implementation |
+| Workflow cancellation and compensation | Temporal separates workflow state from worker execution and makes lifecycle state explicit. | Add an explicit cancellation transition and caller-owned compensation callback to the existing resumable run contract. | Select for implementation |
+| Artifact retention policy | Crawlee, release systems and storage projects separate durable results from transient worker state. | Add retention metadata and deterministic pruning decisions to artifact manifests without deleting caller data implicitly. | Select for implementation |
+
+## Rejected or deferred patterns
+
+Hosted stealth browsers, automatic proxy rotation, CAPTCHA solving, embedded object stores, cloud-specific dispatch APIs, native worker modules in the universal export graph and copying provider-specific code are rejected or deferred. They either violate caller-owned infrastructure, expand the security boundary, conflict with transport neutrality or require a separate legal and operational decision.
+
+## References
+
+[1]: https://github.com/browserbase/stagehand "Stagehand repository"
+[2]: https://github.com/apify/crawlee "Crawlee repository"
+[3]: https://github.com/temporalio/sdk-typescript "Temporal TypeScript SDK repository"
+[4]: https://github.com/minio/minio "MinIO repository"
+[5]: https://github.com/browser-use/browser-use "Browser Use repository"
+[6]: https://github.com/Scrapy/scrapy "Scrapy repository"

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Saddle browser bridge",
-  "version": "1.8.12",
+  "version": "1.8.13",
   "description": "User initiated page snapshots through the Saddle browser contract.",
   "minimum_chrome_version": "110",
   "permissions": ["activeTab", "scripting", "storage"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenathlan/saddle",
-  "version": "1.8.12",
+  "version": "1.8.13",
   "description": "binary computing engine that turns distributed storage into a publishable working set",
   "type": "module",
   "private": false,