DEVELOPER TOOLS / 0.1.0

Add decisions
to your code.

Two server-side clients, an open API contract and a ready-to-use skill for your coding agent. One API for Choice, Score and Noul.

01 / PYTHON 3.10+

Python

A synchronous client with no third-party runtime dependencies.

install · 0.1.0
python -m pip install https://shvydko.ai/sdk/shvydko_client-0.1.0-py3-none-any.whl
server.py
import os
from shvydko_client import Shvydko

client = Shvydko(os.environ["SHVYDKO_API_KEY"])
result = client.decide(
    state="Checkout is broken. Delivery tracking works.",
    questions={"team": {"type": "choice",
        "criteria": {"engineering": "Site defects",
                     "logistics": "Delivery"}}},
)
print(result["answers"]["team"])
02 / NODE.JS 20+

TypeScript / JavaScript

Request and response types, fetch and a configurable timeout.

install · 0.1.0
npm install https://shvydko.ai/sdk/shvydko-client-0.1.0.tgz
server.mjs
import { Shvydko } from "@shvydko/client";

const client = new Shvydko({
  apiKey: process.env.SHVYDKO_API_KEY,
});
const result = await client.decide({
  state: "Checkout is broken. Delivery tracking works.",
  questions: {team: {type: "choice", criteria: {
    engineering: "Site defects", logistics: "Delivery",
  }}},
});
console.log(result.answers.team);

This is a preview release of the Codebridge clients. The packages are hosted on shvydko.ai; they are not published on npm or PyPI. Direct HTTP examples remain available.

Predictable behavior.

  • One call, one HTTP request. No automatic retries after a timeout.
  • Errors include the HTTP status and request ID when available. The secret and input text are not included in error messages.
  • The key stays on the server. Redirects to another address are not followed.
  • Python: timeout limits socket inactivity. TypeScript: timeoutMs limits the entire request, including reading the response. The default is 120 seconds.
  • The SDK version does not pin the model. Check revision through GET /v1/models and pass it as model if you need a specific available version.
Status codes and error handling
03 / CODING AGENTS

Give your agent
the right API contract.

The archive includes SKILL.md and an API reference. Extract the shvydko-api folder into your agent’s skills directory, following its instructions.

Download agent skillDocumentation for agents

Or start with this prompt

Integrate Shvydko into my server-side application. Read https://shvydko.ai/en/llms.txt and https://shvydko.ai/openapi.json. Check the current SDKs and agent skill at https://shvydko.ai/en/developers. Use SHVYDKO_API_KEY from the server environment; do not reveal the key or send it to the browser. Prepare state and Choice, Score or Noul questions for my workflow. Validate the response structure, request_id, usage and the path for human review. Do not automatically retry POST after a timeout. Do not perform an external business action solely on the basis of a model response.

Release files

Version 0.1.0 · October 18, 2026 · MIT. Use the checksums to verify your downloads.

Python wheel 4,294 bytes
SHA256747004fba3fa45894cb188633bc252b479d12e6dc3394152c6bcfc883387c60e
Agent skill 2,629 bytes
SHA2566bf5ac6d31d00eba3ac2efacba3609f3bf6eabd3f143ffe6ce8fa25c2a167440
Manifest JSON

Test it on your workflow.

The recipes combine model decisions with data validation, permitted actions and human review.

Open cookbooks