phaseo-sdk-typescript
/phaseo-sdk-typescript
Builds Phaseo integrations with the official TypeScript and JavaScript SDK, `@phaseo/sdk`: one shared client, `generateResponse` and streaming, images, audio, async video, presets, model discovery and request IDs for debugging. Use when a project depends on or should adopt `@phaseo/sdk` in Node.js, Bun or edge runtimes. Not for agent loops (use phaseo-agent-sdk-typescript), Python (phaseo-sdk-python) or code that keeps the OpenAI SDK with a swapped base URL (phaseo-gateway).
- Author
- phaseoteam ↗
- Repository
- phaseo ↗
- Licence
- AGPL-3.0
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.
What it does and when to use it
Builds Phaseo integrations with the official TypeScript and JavaScript SDK, `@phaseo/sdk`: one shared client, `generateResponse` and streaming, images, audio, async video, presets, model discovery and request IDs for debugging. Use when a project depends on or should adopt `@phaseo/sdk` in Node.js, Bun or edge runtimes. Not for agent loops (use phaseo-agent-sdk-typescript), Python (phaseo-sdk-python) or code that keeps the OpenAI SDK with a swapped base URL (phaseo-gateway).
Original author description
Builds Phaseo integrations with the official TypeScript and JavaScript SDK, `@phaseo/sdk`: one shared client, `generateResponse` and streaming, images, audio, async video, presets, model discovery and request IDs for debugging. Use when a project depends on or should adopt `@phaseo/sdk` in Node.js, Bun or edge runtimes. Not for agent loops (use phaseo-agent-sdk-typescript), Python (phaseo-sdk-python) or code that keeps the OpenAI SDK with a swapped base URL (phaseo-gateway).
How it works
- Outcome
- Workflow
- Canonical client setup
- Preferred surface selection
- Rules
- Validation
SKILL.md preview
---
name: phaseo-sdk-typescript
description: "Builds Phaseo integrations with the official TypeScript and JavaScript SDK, `@phaseo/sdk`: one shared client, `generateResponse` and streaming, images, audio, async video, presets, model discovery and request IDs for debugging. Use when a project depends on or should adopt `@phaseo/sdk` in Node.js, Bun or edge runtimes. Not for agent loops (use phaseo-agent-sdk-typescript), Python (phaseo-sdk-python) or code that keeps the OpenAI SDK with a swapped base URL (phaseo-gateway)."
license: MIT
---
# Phaseo SDK TypeScript
Use this skill when the repository should call Phaseo through `@phaseo/sdk` instead of raw fetch or another compatibility client.
## Outcome
Deliver a working TypeScript or JavaScript integration that:
- imports `Phaseo` from `@phaseo/sdk`
- reads credentials from `PHASEO_API_KEY`
- uses the smallest suitable SDK surface
- preserves request ids and model ids for debugging
## Workflow
1. Create one shared `Phaseo` client.
2. Prefer the Responses API for new text integrations.
3. Reuse preset slugs instead of copying prompt and routing defaults into each caller.
4. For async video, store the returned job id and poll until terminal.
5. Validate with one small request on the exact surface you changed.
## Canonical client setup
```ts
import { Phaseo } from "@phaseo/sdk";
export const gateway = new Phaseo({
apiKey: process.env.PHASEO_API_KEY!,
});
```
## Preferred surface selection
- Text and multimodal generation: `generateResponse` or `streamResponse`
- Chat-style compatibility only when the caller already expects chat-shape messages
- Images: `generateImage`, `generateImageEdit`
- Audio: `generateSpeech`, `generateTranscription`, `generateTranslation`
- Video: `generateVideo`
- Discovery: `getModels`, `getHealth`
## Rules
- Prefer `generateResponse` for net-new text features unless a caller already depends on chat-specific shape.
- Keep model ids configurable and discover current ids from `/v1/models` or existing gateway discovery helpers.
- Keep API keys in env vars only.
- If the repository already has request logging, include request id, model id, and preset slug when available.
## Validation
- one successful request on the changed endpoint
- one error-path check when auth or model lookup behavior changed
- confirm async jobs are tracked by returned id instead of assuming immediate completion
Files in this package (3)
- SKILL.md 2 KB
- agents/openai.yaml 1 KB
- evals/evals.json 1 KB
Versions
The database has no other skills named phaseo-sdk-typescript.
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version 402bfb89b11d (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100phaseo-sdk-python
Builds Phaseo integrations with the official Python SDK, `phaseo`: one shared client, `generate_response` and streaming, images, audio, async video, presets, model discovery and request IDs for debugging. Use when a Python project depends on or should adopt `phaseo`, in scripts,… - 90phaseo-gateway
Integrates applications with the Phaseo Gateway over OpenAI-compatible REST, the TypeScript SDK (`@phaseo/sdk`), the Python SDK (`phaseo`) or the Vercel AI SDK provider (`@phaseo/ai-sdk-provider`): base URL, API key auth, attribution headers, model IDs and smoke tests. Use when… - 90sentry-node-sdk
Full Sentry SDK setup for Node.js, Bun, and Deno. Use when asked to "add Sentry to Node.js", "add Sentry to Bun", "add Sentry to Deno", "install @sentry/node", "@sentry/bun", or "@sentry/deno", or configure error monitoring, tracing, logging, profiling, metrics, crons, or AI… - 100mcp-server-building-typescript-sdk
Use this skill when developing custom, production-ready MCP servers using the official @modelcontextprotocol/sdk TypeScript library. - 100scrapfly-sdk-typescript
Web scraping from TypeScript or JavaScript with the Scrapfly SDK (`scrapfly-sdk`). Use when the user asks to scrape a URL, bypass anti-bot protection, render JavaScript, capture screenshots, or extract structured data from Node.js, Deno, or Bun. - 96typescript-sdk
TypeScript SDK patterns for Opik. Use when working in sdks/typescript.