@usestratus/sdk 1.3.0 → 1.6.0

package/README.md

@@ -13,17 +13,17 @@
 [![npm version](https://img.shields.io/npm/v/@usestratus/sdk)](https://www.npmjs.com/package/@usestratus/sdk)
 [![CI](https://github.com/tylergibbs1/stratus/actions/workflows/ci.yml/badge.svg)](https://github.com/tylergibbs1/stratus/actions/workflows/ci.yml)
 
-A better TypeScript agent SDK for Azure OpenAI. Build multi-agent systems with tools, handoffs, guardrails, streaming, structured output, and more.
+A TypeScript agent SDK purpose-built for Azure OpenAI.
 
-- **Built for Azure, not bolted on** — auto-endpoint detection, Entra ID auth, content filter errors as typed exceptions, and built-in retry. No 404 config spirals, no "which SDK do I use" confusion.
-- **Two API backends, one interface** — Chat Completions and Responses API through the same agent, tool, and session code. Start with one, switch with a single line.
-- **Multi-agent orchestration** — handoffs, subagents, guardrails, and hooks compose through a single run loop. Hooks can deny or modify tool calls at runtime.
-- **Human-in-the-loop** — `canUseTool` permission callbacks, `needsApproval` per tool, `allowedTools` glob filtering, and graceful `interrupt()` for stopping runs mid-flight.
-- **Client-side state you control** — save, resume, and fork conversations as portable JSON snapshots. Hot-swap tools mid-session. No server-side threads, no opaque session IDs.
-- **Type-safe from schema to output** — Zod schemas drive tool parameters, structured output, and validation. Context types flow through agents, hooks, and guardrails at compile time.
-- **Zero dependencies** — only Zod as a peer dep. No transitive dependency sprawl, no framework lock-in.
+- **One line to start** — `createModel()` reads your env vars. No config objects, no API version guessing.
+- **One interface, two backends** — Chat Completions and Responses API through the same agent, tool, and session code.
+- **Agents that compose** — handoffs, subagents, guardrails, and hooks in a single run loop. Deny or modify tool calls at runtime.
+- **Human-in-the-loop** — permission callbacks, per-tool approval, glob-filtered tools, and graceful mid-run interrupts.
+- **State you own** — save, resume, and fork conversations as JSON. No server-side threads.
+- **Type-safe end to end** — Zod schemas drive parameters, structured output, and validation. Types flow through agents, hooks, and guardrails at compile time.
+- **Zero dep** — only Zod as a peer dep.
 
-`agents` `tools` `streaming` `structured output` `handoffs` `subagents` `guardrails` `hooks` `tracing` `sessions` `abort signals` `code mode` `todo tracking` `cost tracking` `human-in-the-loop` `predicted output` `audio` `data sources` `context compaction`
+`agents` `tools` `streaming` `structured output` `handoffs` `subagents` `guardrails` `hooks` `tracing` `sessions` `abort signals` `code mode` `todo tracking` `cost tracking` `human-in-the-loop` `predicted output` `audio` `data sources` `context compaction` `background tasks` `testing utilities` `debug mode`
 
 ## Install
 
@@ -41,13 +41,9 @@ bun add zod
 
 ```ts
 import { z } from "zod";
-import { Agent, AzureResponsesModel, run, tool } from "@usestratus/sdk";
+import { Agent, createModel, run, tool } from "@usestratus/sdk";
 
-const model = new AzureResponsesModel({
-  endpoint: process.env.AZURE_OPENAI_ENDPOINT!,
-  apiKey: process.env.AZURE_OPENAI_API_KEY!,
-  deployment: "gpt-5.2",
-});
+const model = createModel(); // reads AZURE_OPENAI_ENDPOINT, AZURE_OPENAI_API_KEY, AZURE_OPENAI_DEPLOYMENT
 
 const getWeather = tool({
   name: "get_weather",
@@ -161,15 +157,15 @@ import { createSession } from "@usestratus/sdk";
 
 const session = createSession({ model, tools: [myTool] });
 
+// Option 1: stream events
 session.send("Hello!");
 for await (const event of session.stream()) {
   // handle events
 }
 
+// Option 2: just get the result
 session.send("Follow-up question");
-for await (const event of session.stream()) {
-  // handle events
-}
+const result = await session.wait();
 
 // Save and resume sessions
 const snapshot = session.save();
@@ -448,52 +444,91 @@ Implement the `Executor` interface for custom sandboxes (containers, Cloudflare
 
 ## Imports
 
-Stratus provides three export paths:
+Stratus provides four export paths:
 
 ```ts
 // Everything (core + Azure)
-import { Agent, run, tool, AzureChatCompletionsModel, AzureResponsesModel } from "@usestratus/sdk";
+import { Agent, run, tool, createModel } from "@usestratus/sdk";
 
 // Core only (provider-agnostic)
-import { Agent, run, tool } from "@usestratus/sdk/core";
+import { Agent, run, tool, validateAgent } from "@usestratus/sdk/core";
 
 // Azure provider only
-import { AzureChatCompletionsModel, AzureResponsesModel } from "@usestratus/sdk/azure";
+import { createModel, AzureResponsesModel } from "@usestratus/sdk/azure";
+
+// Test utilities (keep out of production bundles)
+import { createMockModel, textResponse, toolCallResponse } from "@usestratus/sdk/testing";
 ```
 
 ## Configuration
 
 ### Azure OpenAI
 
-Stratus includes two interchangeable Azure model implementations:
+The fastest way — `createModel()` reads from environment variables:
 
 ```ts
-// Chat Completions API
-const model = new AzureChatCompletionsModel({
-  endpoint: process.env.AZURE_OPENAI_ENDPOINT!,
-  apiKey: process.env.AZURE_OPENAI_API_KEY!,
-  deployment: "gpt-5.2",
-  apiVersion: "2025-03-01-preview", // optional, this is the default
-});
+import { createModel } from "@usestratus/sdk";
+
+const model = createModel();                    // Responses API (default)
+const model = createModel("chat-completions");  // Chat Completions API
+```
+
+Or configure explicitly:
+
+```ts
+import { AzureResponsesModel } from "@usestratus/sdk";
 
-// Responses API
 const model = new AzureResponsesModel({
-  endpoint: process.env.AZURE_OPENAI_ENDPOINT!,
+  endpoint: "https://your-resource.openai.azure.com",
   apiKey: process.env.AZURE_OPENAI_API_KEY!,
   deployment: "gpt-5.2",
-  apiVersion: "2025-04-01-preview", // optional, this is the default
 });
 ```
 
-Both implement the same `Model` interface — swap one for the other without changing any agent, tool, or session code.
+Both models implement the same `Model` interface — swap one for the other without changing any agent, tool, or session code.
 
 ### Environment Variables
 
 ```
 AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
 AZURE_OPENAI_API_KEY=your-api-key
+AZURE_OPENAI_DEPLOYMENT=gpt-5.2
 ```
 
+## Testing
+
+Stratus ships test utilities as a separate entrypoint:
+
+```ts
+import { createMockModel, textResponse, toolCallResponse } from "@usestratus/sdk/testing";
+
+const model = createMockModel([
+  toolCallResponse([{ name: "search", args: { q: "test" } }]),
+  textResponse("Found 3 results"),
+]);
+
+const agent = new Agent({ name: "test", model, tools: [searchTool] });
+const result = await run(agent, "Search for test");
+expect(result.output).toBe("Found 3 results");
+
+// Capture requests for assertions
+const model = createMockModel([textResponse("ok")], { capture: true });
+await run(agent, "Hello");
+expect(model.requests[0].messages[0].content).toBe("Hello");
+```
+
+## Debug Mode
+
+Log model calls, tool executions, and handoffs to stderr:
+
+```ts
+const result = await run(agent, "Hello", { debug: true });
+// [stratus:model] 2026-04-02T... request to assistant {"messages":2,"tools":1,"turn":0}
+// [stratus:model] 2026-04-02T... response from assistant {"content":"Hi!","toolCalls":[],...}
+```
+
+Also works on sessions: `createSession({ model, debug: true })`.
+
 ## Error Handling
 
 All errors extend `StratusError`:

package/dist/azure/create-model.d.ts

@@ -0,0 +1,16 @@
+import type { Model } from "../core/model";
+export type ModelType = "responses" | "chat-completions";
+export interface CreateModelOptions {
+    endpoint?: string;
+    apiKey?: string;
+    azureAdTokenProvider?: () => Promise<string>;
+    deployment?: string;
+    apiVersion?: string;
+    maxRetries?: number;
+    defaultHeaders?: Record<string, string>;
+    /** Only for AzureResponsesModel */
+    store?: boolean;
+}
+export declare function createModel(type?: ModelType, options?: CreateModelOptions): Model;
+export declare function createModel(options?: CreateModelOptions): Model;
+//# sourceMappingURL=create-model.d.ts.map

package/dist/azure/create-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-model.d.ts","sourceRoot":"","sources":["../../src/azure/create-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAI3C,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,kBAAkB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;AACnF,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC"}

package/dist/azure/create-model.js

@@ -0,0 +1,45 @@
+import { StratusError } from "../core/errors";
+import { AzureChatCompletionsModel } from "./chat-completions-model";
+import { AzureResponsesModel } from "./responses-model";
+export function createModel(typeOrOptions, maybeOptions) {
+    let type = "responses";
+    let options = {};
+    if (typeof typeOrOptions === "string") {
+        type = typeOrOptions;
+        options = maybeOptions ?? {};
+    }
+    else if (typeOrOptions) {
+        options = typeOrOptions;
+    }
+    const endpoint = options.endpoint ?? process.env.AZURE_OPENAI_ENDPOINT;
+    const apiKey = options.apiKey ?? process.env.AZURE_OPENAI_API_KEY;
+    const deployment = options.deployment ?? process.env.AZURE_OPENAI_DEPLOYMENT;
+    const apiVersion = options.apiVersion ?? process.env.AZURE_OPENAI_API_VERSION;
+    const tokenProvider = options.azureAdTokenProvider;
+    if (!endpoint) {
+        throw new StratusError("Missing Azure OpenAI endpoint. Set AZURE_OPENAI_ENDPOINT or pass options.endpoint.");
+    }
+    if (!deployment) {
+        throw new StratusError("Missing Azure OpenAI deployment. Set AZURE_OPENAI_DEPLOYMENT or pass options.deployment.");
+    }
+    if (!apiKey && !tokenProvider) {
+        throw new StratusError("Missing Azure OpenAI credentials. Set AZURE_OPENAI_API_KEY or pass options.apiKey / options.azureAdTokenProvider.");
+    }
+    const baseConfig = {
+        endpoint,
+        deployment,
+        ...(apiKey ? { apiKey } : {}),
+        ...(tokenProvider ? { azureAdTokenProvider: tokenProvider } : {}),
+        ...(apiVersion ? { apiVersion } : {}),
+        ...(options.maxRetries !== undefined ? { maxRetries: options.maxRetries } : {}),
+    };
+    if (type === "chat-completions") {
+        return new AzureChatCompletionsModel(baseConfig);
+    }
+    return new AzureResponsesModel({
+        ...baseConfig,
+        ...(options.store !== undefined ? { store: options.store } : {}),
+        ...(options.defaultHeaders !== undefined ? { defaultHeaders: options.defaultHeaders } : {}),
+    });
+}
+//# sourceMappingURL=create-model.js.map

package/dist/azure/create-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-model.js","sourceRoot":"","sources":["../../src/azure/create-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAkBxD,MAAM,UAAU,WAAW,CAC1B,aAA8C,EAC9C,YAAiC;IAEjC,IAAI,IAAI,GAAc,WAAW,CAAC;IAClC,IAAI,OAAO,GAAuB,EAAE,CAAC;IAErC,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACvC,IAAI,GAAG,aAAa,CAAC;QACrB,OAAO,GAAG,YAAY,IAAI,EAAE,CAAC;IAC9B,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QAC1B,OAAO,GAAG,aAAa,CAAC;IACzB,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAClE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAC9E,MAAM,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAEnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CACrB,oFAAoF,CACpF,CAAC;IACH,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,YAAY,CACrB,0FAA0F,CAC1F,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC/B,MAAM,IAAI,YAAY,CACrB,mHAAmH,CACnH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG;QAClB,QAAQ;QACR,UAAU;QACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;IAEF,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACjC,OAAO,IAAI,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,mBAAmB,CAAC;QAC9B,GAAG,UAAU;QACb,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3F,CAAC,CAAC;AACJ,CAAC"}

package/dist/azure/endpoint.d.ts

@@ -15,4 +15,9 @@ export declare function resolveChatCompletionsUrl(endpoint: string, deployment:
  * Resolve the full URL for Azure Responses API.
  */
 export declare function resolveResponsesUrl(endpoint: string, apiVersion: string): string;
+/**
+ * Resolve the base URL prefix for Responses API sub-endpoints (compact, retrieve, delete, etc.).
+ * Returns the base without a trailing path so callers can append `/compact`, `/{id}`, etc.
+ */
+export declare function resolveResponsesBaseUrl(endpoint: string, apiVersion: string): string;
 //# sourceMappingURL=endpoint.d.ts.map

package/dist/azure/endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/azure/endpoint.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAuBtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAChB,MAAM,CAWR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAYhF"}
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/azure/endpoint.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAuBtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAChB,MAAM,CAWR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAYhF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAkBpF"}

package/dist/azure/endpoint.js

@@ -54,4 +54,26 @@ export function resolveResponsesUrl(endpoint, apiVersion) {
             return `${normalized}/openai/v1/responses`;
     }
 }
+/**
+ * Resolve the base URL prefix for Responses API sub-endpoints (compact, retrieve, delete, etc.).
+ * Returns the base without a trailing path so callers can append `/compact`, `/{id}`, etc.
+ */
+export function resolveResponsesBaseUrl(endpoint, apiVersion) {
+    const normalized = endpoint.replace(/\/$/, "");
+    const kind = detectEndpointKind(normalized);
+    switch (kind) {
+        case "full_url":
+            // If the URL contains /responses, strip everything after it.
+            // Otherwise it's a non-responses full_url (e.g. /openai/deployments/...) —
+            // fall through to standard format since sub-endpoints need the /responses base.
+            if (normalized.includes("/responses")) {
+                return normalized.replace(/\/responses.*$/, "/responses");
+            }
+            return `${new URL(normalized).origin}/openai/v1/responses`;
+        case "foundry":
+            return `${normalized}/openai/responses?api-version=${apiVersion}`;
+        case "standard":
+            return `${normalized}/openai/v1/responses`;
+    }
+}
 //# sourceMappingURL=endpoint.js.map

package/dist/azure/endpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/azure/endpoint.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IAClD,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACJ,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC1B,IACC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EACxB,CAAC;QACF,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACrD,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACxC,QAAgB,EAChB,UAAkB,EAClB,UAAkB;IAElB,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE5C,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,UAAU;YACd,OAAO,UAAU,CAAC;QACnB,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACb,OAAO,GAAG,UAAU,uBAAuB,UAAU,iCAAiC,UAAU,EAAE,CAAC;IACrG,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,UAAkB;IACvE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE5C,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,UAAU;YACd,OAAO,UAAU,CAAC;QACnB,KAAK,SAAS;YACb,OAAO,GAAG,UAAU,iCAAiC,UAAU,EAAE,CAAC;QACnE,KAAK,UAAU;YACd,OAAO,GAAG,UAAU,sBAAsB,CAAC;IAC7C,CAAC;AACF,CAAC"}
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/azure/endpoint.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IAClD,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACJ,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC1B,IACC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EACxB,CAAC;QACF,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACrD,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACxC,QAAgB,EAChB,UAAkB,EAClB,UAAkB;IAElB,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE5C,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,UAAU;YACd,OAAO,UAAU,CAAC;QACnB,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACb,OAAO,GAAG,UAAU,uBAAuB,UAAU,iCAAiC,UAAU,EAAE,CAAC;IACrG,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,UAAkB;IACvE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE5C,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,UAAU;YACd,OAAO,UAAU,CAAC;QACnB,KAAK,SAAS;YACb,OAAO,GAAG,UAAU,iCAAiC,UAAU,EAAE,CAAC;QACnE,KAAK,UAAU;YACd,OAAO,GAAG,UAAU,sBAAsB,CAAC;IAC7C,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,UAAkB;IAC3E,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE5C,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,UAAU;YACd,6DAA6D;YAC7D,2EAA2E;YAC3E,gFAAgF;YAChF,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACvC,OAAO,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,sBAAsB,CAAC;QAC5D,KAAK,SAAS;YACb,OAAO,GAAG,UAAU,iCAAiC,UAAU,EAAE,CAAC;QACnE,KAAK,UAAU;YACd,OAAO,GAAG,UAAU,sBAAsB,CAAC;IAC7C,CAAC;AACF,CAAC"}

package/dist/azure/index.d.ts

@@ -1,5 +1,7 @@
+export { createModel } from "./create-model";
+export type { CreateModelOptions, ModelType } from "./create-model";
 export { AzureChatCompletionsModel } from "./chat-completions-model";
 export type { AzureChatCompletionsModelConfig } from "./chat-completions-model";
 export { AzureResponsesModel } from "./responses-model";
-export type { AzureResponsesModelConfig } from "./responses-model";
+export type { AzureResponsesModelConfig, CompactOptions, CompactResponse, InputItemList, McpApprovalResponseItem, RawResponse, ResponseStatus, RetrieveStreamOptions, } from "./responses-model";
 //# sourceMappingURL=index.d.ts.map

package/dist/azure/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/azure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/azure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACX,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,WAAW,EACX,cAAc,EACd,qBAAqB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/azure/index.js

@@ -1,3 +1,4 @@
+export { createModel } from "./create-model";
 export { AzureChatCompletionsModel } from "./chat-completions-model";
 export { AzureResponsesModel } from "./responses-model";
 //# sourceMappingURL=index.js.map

package/dist/azure/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/azure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/azure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/azure/responses-model.d.ts

@@ -6,20 +6,94 @@ export interface AzureResponsesModelConfig {
     deployment: string;
     apiVersion?: string;
     store?: boolean;
+    /** Extra headers sent with every Responses API request. Useful for Azure preview feature headers. */
+    defaultHeaders?: Record<string, string>;
     /** Maximum number of retries on 429 / network errors (default 3). */
     maxRetries?: number;
 }
+export type ResponseStatus = "queued" | "in_progress" | "completed" | "failed" | "incomplete" | "cancelled";
+export interface RawResponse {
+    id: string;
+    status: ResponseStatus;
+    output?: Record<string, unknown>[];
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    };
+    incomplete_details?: {
+        reason?: string;
+    };
+    error?: {
+        message?: string;
+        type?: string;
+        code?: string;
+    };
+    [key: string]: unknown;
+}
+export interface CompactOptions {
+    model?: string;
+    input?: Record<string, unknown>[];
+    previousResponseId?: string;
+    signal?: AbortSignal;
+}
+export interface CompactResponse {
+    output: Record<string, unknown>[];
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface InputItemList {
+    data: Record<string, unknown>[];
+    hasMore: boolean;
+    firstId?: string;
+    lastId?: string;
+}
+export interface McpApprovalResponseItem {
+    type: "mcp_approval_response";
+    approval_request_id: string;
+    approve: boolean;
+}
+export interface RetrieveStreamOptions {
+    startingAfter?: number;
+    signal?: AbortSignal;
+}
 export declare class AzureResponsesModel implements Model {
     private readonly url;
+    private readonly baseUrl;
     private readonly apiKey?;
     private readonly tokenProvider?;
     private readonly deployment;
     private readonly store;
+    private readonly defaultHeaders;
     private readonly maxRetries;
     constructor(config: AzureResponsesModelConfig);
     private getAuthHeaders;
     getResponse(request: ModelRequest, options?: ModelRequestOptions): Promise<ModelResponse>;
     getStreamedResponse(request: ModelRequest, options?: ModelRequestOptions): AsyncGenerator<StreamEvent>;
+    compact(options: CompactOptions): Promise<CompactResponse>;
+    createBackgroundResponse(request: ModelRequest, options?: ModelRequestOptions & {
+        stream?: boolean;
+    }): Promise<RawResponse>;
+    streamBackgroundResponse(responseId: string, options?: RetrieveStreamOptions): AsyncGenerator<StreamEvent>;
+    retrieveResponse(responseId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<RawResponse>;
+    deleteResponse(responseId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    cancelResponse(responseId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<RawResponse>;
+    listInputItems(responseId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<InputItemList>;
+    private resolveSubEndpoint;
+    private urlHasQuery;
+    private doFetchUrl;
+    private mapSseEvent;
     private buildRequestBody;
     private doFetch;
     private handleErrorResponse;

package/dist/azure/responses-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responses-model.d.ts","sourceRoot":"","sources":["../../src/azure/responses-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEX,KAAK,EACL,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,WAAW,EAEX,MAAM,eAAe,CAAC;AAcvB,MAAM,WAAW,yBAAyB;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAsCD,qBAAa,mBAAoB,YAAW,KAAK;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,yBAAyB;YAe/B,cAAc;IAStB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBxF,mBAAmB,CACzB,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,cAAc,CAAC,WAAW,CAAC;IA6M9B,OAAO,CAAC,gBAAgB;YAoEV,OAAO;YA8EP,mBAAmB;IA2BjC,OAAO,CAAC,aAAa;CAmCrB"}
+{"version":3,"file":"responses-model.d.ts","sourceRoot":"","sources":["../../src/azure/responses-model.ts"],"names":[],"mappings":"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"}