@openrouter/sdk 1.2.136 → 1.2.137

package/esm/models/internchattoolcall.d.ts

@@ -0,0 +1,30 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { InternChatToolCallFunction } from "./internchattoolcallfunction.js";
+export declare const InternChatToolCallType: {
+    readonly Function: "function";
+};
+export type InternChatToolCallType = ClosedEnum<typeof InternChatToolCallType>;
+/**
+ * An `openrouter.provide_input` request. The run pauses on the daemon until a `tool` message answers it, the caller cancels it, or its interaction deadline passes.
+ */
+export type InternChatToolCall = {
+    /**
+     * The single tool this endpoint calls, asking the caller for input.
+     */
+    function: InternChatToolCallFunction;
+    /**
+     * The interaction id. Send it back as `tool_call_id` on the `tool` message that answers it.
+     */
+    id: string;
+    index: number;
+    type: InternChatToolCallType;
+};
+/** @internal */
+export declare const InternChatToolCallType$inboundSchema: z.ZodEnum<typeof InternChatToolCallType>;
+/** @internal */
+export declare const InternChatToolCall$inboundSchema: z.ZodType<InternChatToolCall, unknown>;
+export declare function internChatToolCallFromJSON(jsonString: string): SafeParseResult<InternChatToolCall, SDKValidationError>;
+//# sourceMappingURL=internchattoolcall.d.ts.map

package/esm/models/internchattoolcall.js

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ab9593cbcfd4
+ */
+import * as z from "zod/v4";
+import { safeParse } from "../lib/schemas.js";
+import { InternChatToolCallFunction$inboundSchema, } from "./internchattoolcallfunction.js";
+export const InternChatToolCallType = {
+    Function: "function",
+};
+/** @internal */
+export const InternChatToolCallType$inboundSchema = z.enum(InternChatToolCallType);
+/** @internal */
+export const InternChatToolCall$inboundSchema = z.object({
+    function: InternChatToolCallFunction$inboundSchema,
+    id: z.string(),
+    index: z.int(),
+    type: InternChatToolCallType$inboundSchema,
+});
+export function internChatToolCallFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => InternChatToolCall$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'InternChatToolCall' from JSON`);
+}
+//# sourceMappingURL=internchattoolcall.js.map

package/esm/models/internchattoolcallfunction.d.ts

@@ -0,0 +1,24 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+export declare const InternChatToolCallFunctionName: {
+    readonly OpenrouterProvideInput: "openrouter.provide_input";
+};
+export type InternChatToolCallFunctionName = ClosedEnum<typeof InternChatToolCallFunctionName>;
+/**
+ * The single tool this endpoint calls, asking the caller for input.
+ */
+export type InternChatToolCallFunction = {
+    /**
+     * A JSON object string describing the interaction. A permission request is `{"kind":"permission","operation":<tool name or null>,"options":[<permission option kinds>]}`. A question is `{"kind":"elicitation","message":<question>,"fields":[<field descriptors>]}`.
+     */
+    arguments: string;
+    name: InternChatToolCallFunctionName;
+};
+/** @internal */
+export declare const InternChatToolCallFunctionName$inboundSchema: z.ZodEnum<typeof InternChatToolCallFunctionName>;
+/** @internal */
+export declare const InternChatToolCallFunction$inboundSchema: z.ZodType<InternChatToolCallFunction, unknown>;
+export declare function internChatToolCallFunctionFromJSON(jsonString: string): SafeParseResult<InternChatToolCallFunction, SDKValidationError>;
+//# sourceMappingURL=internchattoolcallfunction.d.ts.map

package/esm/models/internchattoolcallfunction.js

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5a9b88a1d80e
+ */
+import * as z from "zod/v4";
+import { safeParse } from "../lib/schemas.js";
+export const InternChatToolCallFunctionName = {
+    OpenrouterProvideInput: "openrouter.provide_input",
+};
+/** @internal */
+export const InternChatToolCallFunctionName$inboundSchema = z.enum(InternChatToolCallFunctionName);
+/** @internal */
+export const InternChatToolCallFunction$inboundSchema = z.object({
+    arguments: z.string(),
+    name: InternChatToolCallFunctionName$inboundSchema,
+});
+export function internChatToolCallFunctionFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => InternChatToolCallFunction$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'InternChatToolCallFunction' from JSON`);
+}
+//# sourceMappingURL=internchattoolcallfunction.js.map

package/esm/models/internchattoolmessage.d.ts

@@ -0,0 +1,23 @@
+import * as z from "zod/v4";
+import { InternChatMessageContent, InternChatMessageContent$Outbound } from "./internchatmessagecontent.js";
+/**
+ * The answer to an `openrouter.provide_input` tool call. `tool_call_id` is the streamed tool call id and `session_id` must name the same session. For a permission, `content` is one of the offered option kinds (`allow_once`, `allow_always`, `reject_once`, `reject_always`) or `cancel`. For a question (elicitation), `content` is a JSON object string with `action` (`accept`, `decline` or `cancel`) and, for `accept`, `content` holding the field values. The answer is delivered to the run that asked. It never starts a new run.
+ */
+export type InternChatToolMessage = {
+    /**
+     * Message text as a string or a list of text parts. Assistant history may carry null. Only the last message is read; earlier messages are accepted so ordinary clients can resend history.
+     */
+    content: InternChatMessageContent | null;
+    role: "tool";
+    toolCallId: string;
+};
+/** @internal */
+export type InternChatToolMessage$Outbound = {
+    content: InternChatMessageContent$Outbound | null;
+    role: "tool";
+    tool_call_id: string;
+};
+/** @internal */
+export declare const InternChatToolMessage$outboundSchema: z.ZodType<InternChatToolMessage$Outbound, InternChatToolMessage>;
+export declare function internChatToolMessageToJSON(internChatToolMessage: InternChatToolMessage): string;
+//# sourceMappingURL=internchattoolmessage.d.ts.map

package/esm/models/internchattoolmessage.js

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8ef92162c037
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { InternChatMessageContent$outboundSchema, } from "./internchatmessagecontent.js";
+/** @internal */
+export const InternChatToolMessage$outboundSchema = z.object({
+    content: z.nullable(InternChatMessageContent$outboundSchema),
+    role: z.literal("tool"),
+    toolCallId: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        toolCallId: "tool_call_id",
+    });
+});
+export function internChatToolMessageToJSON(internChatToolMessage) {
+    return JSON.stringify(InternChatToolMessage$outboundSchema.parse(internChatToolMessage));
+}
+//# sourceMappingURL=internchattoolmessage.js.map

package/esm/models/internchatusage.d.ts

@@ -0,0 +1,24 @@
+import * as z from "zod/v4";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { InternChatPromptTokensDetails } from "./internchatprompttokensdetails.js";
+/**
+ * Token usage for the run as the daemon reported it, on the final chunk before `[DONE]`. `null` when the daemon reported none, and always `null` after `tool_calls` because the turn is not over.
+ */
+export type InternChatUsage = {
+    completionTokens: number;
+    /**
+     * The cost of the run in USD, when the daemon reported one.
+     */
+    cost?: number | undefined;
+    promptTokens: number;
+    /**
+     * Prompt tokens served from cache, when the daemon reported them.
+     */
+    promptTokensDetails?: InternChatPromptTokensDetails | undefined;
+    totalTokens: number;
+};
+/** @internal */
+export declare const InternChatUsage$inboundSchema: z.ZodType<InternChatUsage, unknown>;
+export declare function internChatUsageFromJSON(jsonString: string): SafeParseResult<InternChatUsage, SDKValidationError>;
+//# sourceMappingURL=internchatusage.d.ts.map

package/esm/models/internchatusage.js

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 49d346597315
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { InternChatPromptTokensDetails$inboundSchema, } from "./internchatprompttokensdetails.js";
+/** @internal */
+export const InternChatUsage$inboundSchema = z.object({
+    completion_tokens: z.int(),
+    cost: z.number().optional(),
+    prompt_tokens: z.int(),
+    prompt_tokens_details: InternChatPromptTokensDetails$inboundSchema.optional(),
+    total_tokens: z.int(),
+}).transform((v) => {
+    return remap$(v, {
+        "completion_tokens": "completionTokens",
+        "prompt_tokens": "promptTokens",
+        "prompt_tokens_details": "promptTokensDetails",
+        "total_tokens": "totalTokens",
+    });
+});
+export function internChatUsageFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => InternChatUsage$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'InternChatUsage' from JSON`);
+}
+//# sourceMappingURL=internchatusage.js.map

package/esm/models/internchatusermessage.d.ts

@@ -0,0 +1,21 @@
+import * as z from "zod/v4";
+import { InternChatMessageContent, InternChatMessageContent$Outbound } from "./internchatmessagecontent.js";
+/**
+ * A user message. When it is the last message its text is the prompt for a new run, at most 32000 characters.
+ */
+export type InternChatUserMessage = {
+    /**
+     * Message text as a string or a list of text parts. Assistant history may carry null. Only the last message is read; earlier messages are accepted so ordinary clients can resend history.
+     */
+    content: InternChatMessageContent | null;
+    role: "user";
+};
+/** @internal */
+export type InternChatUserMessage$Outbound = {
+    content: InternChatMessageContent$Outbound | null;
+    role: "user";
+};
+/** @internal */
+export declare const InternChatUserMessage$outboundSchema: z.ZodType<InternChatUserMessage$Outbound, InternChatUserMessage>;
+export declare function internChatUserMessageToJSON(internChatUserMessage: InternChatUserMessage): string;
+//# sourceMappingURL=internchatusermessage.d.ts.map

package/esm/models/internchatusermessage.js

@@ -0,0 +1,15 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6d3909ea9433
+ */
+import * as z from "zod/v4";
+import { InternChatMessageContent$outboundSchema, } from "./internchatmessagecontent.js";
+/** @internal */
+export const InternChatUserMessage$outboundSchema = z.object({
+    content: z.nullable(InternChatMessageContent$outboundSchema),
+    role: z.literal("user"),
+});
+export function internChatUserMessageToJSON(internChatUserMessage) {
+    return JSON.stringify(InternChatUserMessage$outboundSchema.parse(internChatUserMessage));
+}
+//# sourceMappingURL=internchatusermessage.js.map

package/esm/models/operations/createinternchatcompletion.d.ts

@@ -0,0 +1,61 @@
+import * as z from "zod/v4";
+import * as models from "../index.js";
+export type CreateInternChatCompletionGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type CreateInternChatCompletionRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * The intern to talk to.
+     */
+    internId: string;
+    internChatCompletionRequest: models.InternChatCompletionRequest;
+};
+/** @internal */
+export type CreateInternChatCompletionRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    internId: string;
+    InternChatCompletionRequest: models.InternChatCompletionRequest$Outbound;
+};
+/** @internal */
+export declare const CreateInternChatCompletionRequest$outboundSchema: z.ZodType<CreateInternChatCompletionRequest$Outbound, CreateInternChatCompletionRequest>;
+export declare function createInternChatCompletionRequestToJSON(createInternChatCompletionRequest: CreateInternChatCompletionRequest): string;
+//# sourceMappingURL=createinternchatcompletion.d.ts.map

package/esm/models/operations/createinternchatcompletion.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0d92e801a635
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import * as models from "../index.js";
+/** @internal */
+export const CreateInternChatCompletionRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    internId: z.string(),
+    internChatCompletionRequest: models.InternChatCompletionRequest$outboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        internChatCompletionRequest: "InternChatCompletionRequest",
+    });
+});
+export function createInternChatCompletionRequestToJSON(createInternChatCompletionRequest) {
+    return JSON.stringify(CreateInternChatCompletionRequest$outboundSchema.parse(createInternChatCompletionRequest));
+}
+//# sourceMappingURL=createinternchatcompletion.js.map

package/esm/models/operations/index.d.ts

@@ -14,6 +14,7 @@ export * from "./createembeddings.js";
 export * from "./createguardrail.js";
 export * from "./createimages.js";
 export * from "./createintern.js";
+export * from "./createinternchatcompletion.js";
 export * from "./createkeys.js";
 export * from "./createoauthtoken.js";
 export * from "./createobservabilitydestination.js";

package/esm/models/operations/index.js

@@ -18,6 +18,7 @@ export * from "./createembeddings.js";
 export * from "./createguardrail.js";
 export * from "./createimages.js";
 export * from "./createintern.js";
+export * from "./createinternchatcompletion.js";
 export * from "./createkeys.js";
 export * from "./createoauthtoken.js";
 export * from "./createobservabilitydestination.js";

package/esm/sdk/interns.d.ts

@@ -1,3 +1,4 @@
+import { EventStream } from "../lib/event-streams.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
@@ -51,5 +52,24 @@ export declare class Interns extends ClientSDK {
      * Stops the intern runtime while keeping its disk and configuration for a later provision call. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     suspendIntern(request: operations.SuspendInternRequest, options?: RequestOptions): Promise<models.SuspendInternResponse>;
+    /**
+     * Stream a chat completion with an intern
+     *
+     * @remarks
+     * Sends a prompt to one of your interns and streams the reply as OpenAI-compatible server-sent events ending with `[DONE]`. The run executes on the intern, which may pause to ask you something. It then streams one `openrouter.provide_input` tool call and finishes with `finish_reason: "tool_calls"`, and the run stays open on the intern.
+     *
+     * Every response, whether it ends with `stop`, `tool_calls` or `error`, is followed by a final chunk with empty `choices` that carries `session_id`, then `data: [DONE]`. That chunk carries the `usage` the intern reported for the run, after `stop` or `error`, and `null` when the intern reported none. After `tool_calls` its `usage` is `null` because the turn is not over. Read through `[DONE]`: the `session_id` you need to reply arrives after the `tool_calls` finish chunk.
+     *
+     * To answer, send a second request with the same `session_id`, the assistant message echoing that tool call, and a `tool` message whose `tool_call_id` is the tool call id and whose `content` is the answer. The answer is delivered to the run that asked and the stream continues from where it paused. A question stays open for its interaction deadline (5 minutes by default) and the run is cancelled when that passes. Rejected replies do not extend the deadline.
+     *
+     * Closing the connection after the `[DONE]` that follows `finish_reason: "tool_calls"` keeps the run alive. Disconnecting while a response is still streaming cancels the run. The disconnect is noticed when the intern next writes to the stream, which during a silent tool run can take more than one 30 second heartbeat interval.
+     *
+     * A run the intern ends while you are still connected, by cancellation or by a deadline, ends the stream with a `finish_reason: "error"` chunk carrying `410` and reason `run_ended`, then the final empty-`choices` chunk and `[DONE]`. That error reports only an ending the intern confirmed. A connection that breaks without that confirmation ends with reason `stream_severed`, and a client that has already disconnected is promised no final event.
+     *
+     * Set `approval_mode` to `manual` to have the intern ask before approval-bearing tools such as the shell. Omitted, the run self-drives and consents on your behalf. The mode belongs to the run started by that prompt and must be repeated on later prompts.
+     *
+     * Available to interns programme members. Callers outside the programme receive `404` for every path under `/api/v1/interns`.
+     */
+    chat(request: operations.CreateInternChatCompletionRequest, options?: RequestOptions): Promise<EventStream<models.InternChatCompletionChunk>>;
 }
 //# sourceMappingURL=interns.d.ts.map

package/esm/sdk/interns.js

@@ -2,6 +2,7 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  * @generated-id: fc3b4e6c5008
  */
+import { internsChat } from "../funcs/internsChat.js";
 import { internsCreateIntern } from "../funcs/internsCreateIntern.js";
 import { internsDeleteIntern } from "../funcs/internsDeleteIntern.js";
 import { internsGetIntern } from "../funcs/internsGetIntern.js";
@@ -75,5 +76,26 @@ export class Interns extends ClientSDK {
     async suspendIntern(request, options) {
         return unwrapAsync(internsSuspendIntern(this, request, options));
     }
+    /**
+     * Stream a chat completion with an intern
+     *
+     * @remarks
+     * Sends a prompt to one of your interns and streams the reply as OpenAI-compatible server-sent events ending with `[DONE]`. The run executes on the intern, which may pause to ask you something. It then streams one `openrouter.provide_input` tool call and finishes with `finish_reason: "tool_calls"`, and the run stays open on the intern.
+     *
+     * Every response, whether it ends with `stop`, `tool_calls` or `error`, is followed by a final chunk with empty `choices` that carries `session_id`, then `data: [DONE]`. That chunk carries the `usage` the intern reported for the run, after `stop` or `error`, and `null` when the intern reported none. After `tool_calls` its `usage` is `null` because the turn is not over. Read through `[DONE]`: the `session_id` you need to reply arrives after the `tool_calls` finish chunk.
+     *
+     * To answer, send a second request with the same `session_id`, the assistant message echoing that tool call, and a `tool` message whose `tool_call_id` is the tool call id and whose `content` is the answer. The answer is delivered to the run that asked and the stream continues from where it paused. A question stays open for its interaction deadline (5 minutes by default) and the run is cancelled when that passes. Rejected replies do not extend the deadline.
+     *
+     * Closing the connection after the `[DONE]` that follows `finish_reason: "tool_calls"` keeps the run alive. Disconnecting while a response is still streaming cancels the run. The disconnect is noticed when the intern next writes to the stream, which during a silent tool run can take more than one 30 second heartbeat interval.
+     *
+     * A run the intern ends while you are still connected, by cancellation or by a deadline, ends the stream with a `finish_reason: "error"` chunk carrying `410` and reason `run_ended`, then the final empty-`choices` chunk and `[DONE]`. That error reports only an ending the intern confirmed. A connection that breaks without that confirmation ends with reason `stream_severed`, and a client that has already disconnected is promised no final event.
+     *
+     * Set `approval_mode` to `manual` to have the intern ask before approval-bearing tools such as the shell. Omitted, the run self-drives and consents on your behalf. The mode belongs to the run started by that prompt and must be repeated on later prompts.
+     *
+     * Available to interns programme members. Callers outside the programme receive `404` for every path under `/api/v1/interns`.
+     */
+    async chat(request, options) {
+        return unwrapAsync(internsChat(this, request, options));
+    }
 }
 //# sourceMappingURL=interns.js.map

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "1.2.136",
+  "version": "1.2.137",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "1.2.136",
+  "version": "1.2.137",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 400+ language models through a unified API.",
   "keywords": [
@@ -73,14 +73,14 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "postinstall": "node scripts/check-types.js || true",
+    "compile": "tsc",
     "prepare": "npm run build",
-    "test:e2e": "vitest --run --project e2e",
     "test:transit": "exit 0",
     "test:watch": "vitest --watch --project unit",
-    "typecheck": "tsc --noEmit",
-    "compile": "tsc",
+    "postinstall": "node scripts/check-types.js || true",
     "test": "vitest --run --project unit",
+    "test:e2e": "vitest --run --project e2e",
+    "typecheck": "tsc --noEmit",
     "typecheck:transit": "exit 0"
   },
   "peerDependencies": {},