@standardagents/sip

Overview

@standardagents/sip is now a standalone package published from the standardagents/sip repository. Standard Agents Builder consumes it as an external dependency rather than shipping its image pipeline from inside the monorepo.

Canonical package docs live at:

• https://sip.standardagents.ai
• https://github.com/standardagents/sip

Installation

pnpm add @standardagents/sip

Quick Start

import { collect, inspect, ready, transform } from "@standardagents/sip"

await ready()

const { source } = await inspect(imageBuffer)
const image = transform(source, {
  width: 2048,
  height: 2048,
  quality: 85,
})

const { data, info, stats } = await collect(image)

console.log(info)
// { width, height, mimeType: "image/jpeg", originalFormat }

console.log(stats)
// { peakPipelineBytes, peakCodecBytes, bytesIn, bytesOut, ... }

Worker Response Example

import { inspect, ready, toResponse, transform } from "@standardagents/sip"

export default {
  async fetch(request: Request) {
    await ready()
    const { source } = await inspect(request)
    return toResponse(transform(source, {
      width: 1600,
      height: 1600,
      quality: 82,
    }))
  },
}

Notes

• The new API is stream-first. The main primitives are ready, inspect, transform, collect, toReadableStream, and toResponse.
• transform() constrains width and height while preserving aspect ratio and never upscales.
• A streamed input source can be opened once.
• For a byte budget, retry collect(transform(...)) with lower quality or smaller dimensions. Use retained bytes or a fresh input stream for each attempt. Check the final output size.
• Use the standalone SIP docs for full API reference, examples, and release notes instead of treating Standard Agents Builder docs as the source of truth.