@standardagents/sip 0.13.1 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Standard Agents <justin@standardagents.ai>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -17,6 +17,40 @@
 pnpm add @standardagents/sip
 ```
 
+## Docs Site
+
+The repo includes a small static documentation site built with Arrow and Vite.
+
+```bash
+pnpm docs:dev
+pnpm docs:build
+pnpm docs:preview
+```
+
+- Source files live in `docs/`
+- The production build outputs to `docs-dist/`
+
+## Release
+
+Publishing is handled by GitHub Actions with npm trusted publishing. The workflow
+publishes from version tags and does not use an `NPM_TOKEN`.
+
+```bash
+pnpm verify
+pnpm verify:release
+pnpm release
+pnpm release:next
+pnpm release:dev
+```
+
+- `pnpm release` on `main` bumps `package.json`, commits the new stable version, and pushes the branch plus the `vX.Y.Z` tag
+- `pnpm release:next` and `pnpm release:dev` create a temporary tagged commit like `v1.1.1-next.231fa`, push only the tag, then restore your local branch to the original version
+- You can pass `--bump=major|minor|patch` and `--tag=<dist-tag>` to the release script directly
+- Stable tags create GitHub release notes after a successful npm publish; pre-release tags skip that step
+
+Trusted publishing must be configured in npm for the `standardagents/sip`
+repository and `.github/workflows/publish.yml`.
+
 ## Usage
 
 ```typescript
@@ -131,7 +165,6 @@ cd emsdk && ./emsdk install latest && ./emsdk activate latest
 source ./emsdk_env.sh
 
 # Build WASM
-cd packages/sip
 pnpm build:wasm
 ```
 
@@ -141,19 +174,23 @@ This downloads libjpeg-turbo, compiles it to WASM, and generates:
 
 ### Using WASM
 
-To enable streaming mode, register the WASM loader before processing:
+For Cloudflare Workers and other workerd-based runtimes, the package wires up
+the emitted WASM for you. The normal path is just:
 
 ```typescript
-import { sip } from '@standardagents/sip';
-import createSipModule from '@standardagents/sip/dist/sip.js';
+import { ready, transform, collect } from '@standardagents/sip';
 
-// Register WASM loader (once at startup)
-globalThis.__SIP_WASM_LOADER__ = async () => createSipModule();
+await ready();
 
-// Now sip.process() will use streaming for JPEG
-const result = await sip.process(jpegBuffer, { maxWidth: 2048 });
+const image = transform(request.body ?? request, { width: 2048, height: 2048 });
+const result = await collect(image);
 ```
 
+If you need to override the default loader, `ready({ wasm })` still accepts a
+compiled `WebAssembly.Module` or raw WASM bytes. The
+`globalThis.__SIP_WASM_LOADER__` hook still exists as an internal escape hatch,
+but it is not the intended public setup API.
+
 ## Architecture
 
 ```