dyadic 1.2.0 → 1.3.1

package/CHANGELOG.md

@@ -1,22 +1,32 @@
-# Changelog
-
-## 1.2.0 (2026-10-07)
-
-Security release.
-
-- The API key is only ever sent to the configured API origin. `request()` with an
-  absolute URL on another host, port or scheme, with credentials in it, or
-  protocol-relative, now raises instead of sending the key; redirects are not
-  followed. Plain `http://` base URLs are accepted only for local or
-  private-network APIs.
-- Retries no longer repeat work that may already have run. GET, HEAD, DELETE and
-  OPTIONS retry on busy or failing servers; other requests retry only when they
-  never started (no connection, or Dyadic's `rate_limit_exceeded` /
-  `concurrency_limit` refusal). `409` is no longer retried.
-- Every attempt of one call sends the same `Idempotency-Key` (choose it with
-  `{ idempotencyKey }`, or mark a call safe to replay with `{ idempotent: true }`).
-- The package documents server-side use only (a key must never ship to a browser), builds before `npm test` and `npm pack`, and has a lockfile.
-
-## 1.1.0
-
-- Runs with your own agents and functions, and connected apps (Workspace saves).
+# Changelog
+
+## 1.3.1 (2026-10-10)
+
+- The version the SDK reports (`__version__` / `VERSION`, and the User-Agent header) is the package's
+  own: 1.3.0 still said 1.2.0.
+
+## 1.3.0 (2026-10-10)
+
+- `decisions.create(input, questions, model?)`: typed answers (a predicate's probability, a
+  choice or a score) from `POST /v1/decisions`.
+
+## 1.2.0 (2026-10-07)
+
+Security release.
+
+- The API key is only ever sent to the configured API origin. `request()` with an
+  absolute URL on another host, port or scheme, with credentials in it, or
+  protocol-relative, now raises instead of sending the key; redirects are not
+  followed. Plain `http://` base URLs are accepted only for local or
+  private-network APIs.
+- Retries no longer repeat work that may already have run. GET, HEAD, DELETE and
+  OPTIONS retry on busy or failing servers; other requests retry only when they
+  never started (no connection, or Dyadic's `rate_limit_exceeded` /
+  `concurrency_limit` refusal). `409` is no longer retried.
+- Every attempt of one call sends the same `Idempotency-Key` (choose it with
+  `{ idempotencyKey }`, or mark a call safe to replay with `{ idempotent: true }`).
+- The package documents server-side use only (a key must never ship to a browser), builds before `npm test` and `npm pack`, and has a lockfile.
+
+## 1.1.0
+
+- Runs with your own agents and functions, and connected apps (Workspace saves).

package/README.md

@@ -1,94 +1,114 @@
-# dyadic
-
-```sh
-npm install dyadic
-```
-
-The official TypeScript and JavaScript SDK for the [Dyadic API](https://dyadic.app/developers/): Iris with streaming, function calling, images and typed errors. No dependencies; for server-side code on Node 18+, Deno and Bun (keep your key off the browser, see below).
-
-```ts
-import { Dyadic } from "dyadic";
-
-const client = new Dyadic({ apiKey: process.env.DYADIC_API_KEY });
-console.log(await client.ask("Hello!", { model: "iris" }));
-```
-
-## Keep your key on the server
-
-**A Dyadic API key is a long-lived secret that spends your credits. Never ship it
-to a browser**: not in a bundle, page source, local storage or a request your
-front end makes, where any visitor or extension can copy it. Use the SDK in
-server-side code (Node 18+, Deno, Bun, edge functions) and have your front end
-call your own server:
-
-```ts
-// server.ts: the key stays here
-import { Dyadic } from "dyadic";
-const client = new Dyadic({ apiKey: process.env.DYADIC_API_KEY });
-
-export async function POST(request: Request) {
-  const { question } = await request.json();
-  // Check your own user's session and limits here before spending credits.
-  return Response.json({ answer: await client.ask(String(question).slice(0, 4000), { model: "iris" }) });
-}
-```
-
-`request()` only ever sends the key to the API you configured: a relative path
-joins `baseURL`, and an absolute URL on any other host, port or scheme (or with
-credentials in it) throws `DyadicError` instead of being sent. Redirects are not
-followed. Plain `http://` is accepted only for a local or private-network API.
-
-## Retries
-
-GET, HEAD, DELETE and OPTIONS are retried on busy or failing servers. Anything
-else (a completion, an upload, a run) may already have run, and been billed,
-when it fails, so it is retried only if it provably never started: the
-connection was never made, or Dyadic refused it with `rate_limit_exceeded` or
-`concurrency_limit`. Every attempt of one call carries the same
-`Idempotency-Key`; pass `{ idempotencyKey }` to choose it, or `{ idempotent: true }`
-for a call that is safe to send twice.
-
-## Runs: your own agent, Dyadic's tools, your functions
-
-```ts
-const run = await client.runs.run({
-  agent: { id: "helpdesk", name: "Helpdesk", instructions: "You answer customers of a small shop." },
-  messages: [{ role: "user", content: "Where is order 1042?" }],
-  builtin_tools: ["data.web_search"],
-  functions: {
-    lookup_order: {
-      description: "Look up an order by id.",
-      parameters: { type: "object", properties: { order_id: { type: "string" } }, required: ["order_id"] },
-      handler: async ({ order_id }) => ({ order_id, status: "shipped" }),
-    },
-  },
-  end_user: "customer-17",
-});
-console.log(run.output_text);
-```
-
-`client.runs.create({ ..., stream: true })` streams the run's events.
-
-## Connected apps: saving into a person's Workspace
-
-With the person's approval, an application can save into their Dyadic
-Workspace, naming them by the Discord account linked to their Dyadic account.
-
-```ts
-const status = await client.connections.discord(discordId);
-if (!status.authorized) console.log("Allow this app:", status.authorize_url); // show the person this link
-
-try {
-  const saved = await client.workspace.saves.create({ discord_id: discordId, kind: "message", title: "From #general",
-    text: "Worth keeping", url: "https://discord.com/channels/1/2/3" });
-  console.log(saved.url);
-} catch (error) {
-  if (error instanceof DyadicError && error.code === "authorization_required") console.log("Allow this app:", error.body.authorize_url);
-}
-```
-
-`kind` is `message`, `conversation` (with `messages`, saved as a chat the
-person can continue unless `as_chat: false`), `image` or `file` (with `files`:
-base64, up to 10 of 8 MB).
-
-Full guide: https://dyadic.app/developers/
+# dyadic
+
+```sh
+npm install dyadic
+```
+
+The official TypeScript and JavaScript SDK for the [Dyadic API](https://dyadic.app/developers/): Iris with streaming, function calling, images and typed errors. No dependencies; for server-side code on Node 18+, Deno and Bun (keep your key off the browser, see below).
+
+```ts
+import { Dyadic } from "dyadic";
+
+const client = new Dyadic({ apiKey: process.env.DYADIC_API_KEY });
+console.log(await client.ask("Hello!", { model: "iris" }));
+```
+
+## Keep your key on the server
+
+**A Dyadic API key is a long-lived secret that spends your credits. Never ship it
+to a browser**: not in a bundle, page source, local storage or a request your
+front end makes, where any visitor or extension can copy it. Use the SDK in
+server-side code (Node 18+, Deno, Bun, edge functions) and have your front end
+call your own server:
+
+```ts
+// server.ts: the key stays here
+import { Dyadic } from "dyadic";
+const client = new Dyadic({ apiKey: process.env.DYADIC_API_KEY });
+
+export async function POST(request: Request) {
+  const { question } = await request.json();
+  // Check your own user's session and limits here before spending credits.
+  return Response.json({ answer: await client.ask(String(question).slice(0, 4000), { model: "iris" }) });
+}
+```
+
+`request()` only ever sends the key to the API you configured: a relative path
+joins `baseURL`, and an absolute URL on any other host, port or scheme (or with
+credentials in it) throws `DyadicError` instead of being sent. Redirects are not
+followed. Plain `http://` is accepted only for a local or private-network API.
+
+## Retries
+
+GET, HEAD, DELETE and OPTIONS are retried on busy or failing servers. Anything
+else (a completion, an upload, a run) may already have run, and been billed,
+when it fails, so it is retried only if it provably never started: the
+connection was never made, or Dyadic refused it with `rate_limit_exceeded` or
+`concurrency_limit`. Every attempt of one call carries the same
+`Idempotency-Key`; pass `{ idempotencyKey }` to choose it, or `{ idempotent: true }`
+for a call that is safe to send twice.
+
+## Runs: your own agent, Dyadic's tools, your functions
+
+```ts
+const run = await client.runs.run({
+  agent: { id: "helpdesk", name: "Helpdesk", instructions: "You answer customers of a small shop." },
+  messages: [{ role: "user", content: "Where is order 1042?" }],
+  builtin_tools: ["data.web_search"],
+  functions: {
+    lookup_order: {
+      description: "Look up an order by id.",
+      parameters: { type: "object", properties: { order_id: { type: "string" } }, required: ["order_id"] },
+      handler: async ({ order_id }) => ({ order_id, status: "shipped" }),
+    },
+  },
+  end_user: "customer-17",
+});
+console.log(run.output_text);
+```
+
+`client.runs.create({ ..., stream: true })` streams the run's events.
+
+## Decisions: typed answers, fast and cheap
+
+Ask one or more questions about some text (or text and images) and get typed answers
+back: a probability (`predicate`), one of your values (`choice`) or a rubric level
+(`score`). A fraction of a second and a fraction of a cent; billed at cost.
+
+```ts
+const decision = await client.decisions.create({
+  input: "I can't log in after resetting my password.",
+  questions: [
+    { type: "predicate", name: "urgent", instructions: "The customer is blocked from using the product." },
+    { type: "choice", name: "team", instructions: "Which team should handle this.", choices: [
+      { value: "account", description: "Sign-in and account access" },
+      { value: "billing", description: "Payments and invoices" },
+      { value: "other", description: "Anything else" },
+    ] },
+  ],
+});
+```
+
+## Connected apps: saving into a person's Workspace
+
+With the person's approval, an application can save into their Dyadic
+Workspace, naming them by the Discord account linked to their Dyadic account.
+
+```ts
+const status = await client.connections.discord(discordId);
+if (!status.authorized) console.log("Allow this app:", status.authorize_url); // show the person this link
+
+try {
+  const saved = await client.workspace.saves.create({ discord_id: discordId, kind: "message", title: "From #general",
+    text: "Worth keeping", url: "https://discord.com/channels/1/2/3" });
+  console.log(saved.url);
+} catch (error) {
+  if (error instanceof DyadicError && error.code === "authorization_required") console.log("Allow this app:", error.body.authorize_url);
+}
+```
+
+`kind` is `message`, `conversation` (with `messages`, saved as a chat the
+person can continue unless `as_chat: false`), `image` or `file` (with `files`:
+base64, up to 10 of 8 MB).
+
+Full guide: https://dyadic.app/developers/

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "1.2.0";
+export declare const VERSION = "1.3.1";
 export declare const DEFAULT_BASE_URL = "https://dyadic.app/api/openai/v1";
 export type Model = "iris" | "iris-think" | (string & {});
 export type Role = "system" | "developer" | "user" | "assistant" | "tool";
@@ -310,6 +310,59 @@ export interface Moderation {
         category_applied_input_types: Record<string, string[]>;
     }[];
 }
+export type DecisionQuestion = {
+    type: "predicate";
+    name: string;
+    instructions: string;
+} | {
+    type: "choice";
+    name: string;
+    instructions: string;
+    choices: {
+        value: string;
+        description: string;
+    }[];
+} | {
+    type: "score";
+    name: string;
+    instructions: string;
+    levels: {
+        label: string;
+        description: string;
+    }[];
+};
+export type DecisionAnswer = {
+    type: "predicate";
+    name: string;
+    probability: number;
+} | {
+    type: "choice";
+    name: string;
+    choice: string;
+    probabilities: {
+        value: string;
+        probability: number;
+    }[];
+    confidence: number;
+} | {
+    type: "score";
+    name: string;
+    score: number;
+    probabilities: {
+        value: number;
+        label: string;
+        probability: number;
+    }[];
+    confidence: number;
+} | {
+    type: "refusal";
+    name: string;
+};
+export interface Decision {
+    id: string | null;
+    model: string;
+    answers: DecisionAnswer[];
+}
 export interface FileObject {
     id: string;
     object: "file";
@@ -631,6 +684,17 @@ export declare class Dyadic {
             model?: string;
         }) => Promise<Moderation>;
     };
+    /** Typed answers: each question a predicate (a probability), a choice or a score, about the input. */
+    readonly decisions: {
+        create: (params: {
+            input: string | {
+                role: "user";
+                content: unknown[];
+            }[];
+            questions: DecisionQuestion[];
+            model?: string;
+        }) => Promise<Decision>;
+    };
     readonly images: {
         generate: (params: ImageParams) => Promise<ImageResponse>;
         edit: ({ image, ...params }: Omit<ImageParams, "model"> & {

package/dist/index.js

@@ -1,6 +1,6 @@
 // The official TypeScript SDK for the Dyadic API: Iris
 // through the OpenAI-compatible endpoints at https://dyadic.app/api/openai/v1.
-export const VERSION = "1.2.0";
+export const VERSION = "1.3.1";
 export const DEFAULT_BASE_URL = "https://dyadic.app/api/openai/v1";
 /** Bytes from the API (speech audio, file downloads). */
 export class Binary {
@@ -221,6 +221,10 @@ export class Dyadic {
         this.moderations = {
             create: (params) => this.request("POST", "/moderations", params),
         };
+        /** Typed answers: each question a predicate (a probability), a choice or a score, about the input. */
+        this.decisions = {
+            create: (params) => this.request("POST", "/decisions", params),
+        };
         this.images = {
             generate: (params) => this.request("POST", "/images/generations", params),
             edit: ({ image, ...params }) => this.request("POST", "/images/edits", undefined, false, { form: form(params, { image: [image, "image.png"] }) }),

package/package.json

@@ -1,15 +1,15 @@
-{
-  "name": "dyadic",
-  "version": "1.2.0",
-  "description": "The official TypeScript and JavaScript SDK for the Dyadic API: runs with your own agents and functions, plus the OpenAI-compatible API.",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
-  "files": ["dist", "README.md", "CHANGELOG.md"],
-  "engines": { "node": ">=18" },
-  "license": "MIT",
-  "homepage": "https://dyadic.app/developers/",
-  "scripts": { "build": "tsc", "pretest": "tsc", "test": "node --test test/client.test.js test/transport.test.js", "prepack": "tsc" },
-  "devDependencies": { "typescript": "5.6.3" }
-}
+{
+  "name": "dyadic",
+  "version": "1.3.1",
+  "description": "The official TypeScript and JavaScript SDK for the Dyadic API: runs with your own agents and functions, plus the OpenAI-compatible API.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+  "files": ["dist", "README.md", "CHANGELOG.md"],
+  "engines": { "node": ">=18" },
+  "license": "MIT",
+  "homepage": "https://dyadic.app/developers/",
+  "scripts": { "build": "tsc", "pretest": "tsc", "test": "node --test test/client.test.js test/transport.test.js", "prepack": "tsc" },
+  "devDependencies": { "typescript": "5.6.3" }
+}