Skip to content
Skills Library
Programming · Tool integration

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).

Repository
phaseo ↗
Licence
AGPL-3.0
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

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

  1. Outcome
  2. Workflow
  3. Canonical client setup
  4. Preferred surface selection
  5. Rules
  6. Validation
Original SKILL.md headings · 51 lines, 269 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.