@absolutejs/ai 0.0.52 → 0.0.53

package/README.md

@@ -170,7 +170,10 @@ message transforms, native reasoning controls, prompt and response caching,
 text-plus-audio output, verbosity, user attribution, and an `extraBody` escape
 hatch for new OpenRouter parameters. The escape hatch cannot replace models,
 fallbacks, providers, presets, messages, plugins, or tools; those fields use
-policy-aware typed options instead.
+policy-aware typed options instead. Advisor, Fusion, Shell, Subagent, model
+search, web search/fetch, image generation, Datetime, and Apply Patch server
+tools have typed wire parameters and documented range checks. OpenRouter's old
+`web` plugin is deprecated; use `openrouter:web_search` instead.
 
 URL images and PDFs, base64 audio, and URL/base64 video inputs use the ordinary
 AbsoluteJS content-block contract. URL citations are emitted as `citation`
@@ -213,6 +216,14 @@ const reranked = await openrouterClient.rerank({
   documents: ["response caching", "CSS layout"],
 });
 
+// Response healing is documented for non-streaming structured responses.
+const healed = await openrouterClient.chat({
+  model: "anthropic/claude-sonnet-4.6",
+  messages: [{ role: "user", content: "Return a JSON object" }],
+  response_format: { type: "json_object" },
+  plugins: [{ id: "response-healing" }],
+});
+
 const batch = await openrouterClient.createBatch({
   endpoint: "/v1/chat/completions",
   model: "anthropic/claude-sonnet-4.6",
@@ -249,6 +260,36 @@ const { key } = await exchangeOpenRouterAuthCode({
 });
 ```
 
+### Complete OpenRouter management SDK
+
+The inference adapter stays small and policy-aware. The separate
+`@absolutejs/ai/openrouter/sdk` entry point configures and exposes OpenRouter's
+official OpenAPI-generated TypeScript SDK for the complete administrative and
+data surface:
+
+```ts
+import { createOpenRouterSDK } from "@absolutejs/ai/openrouter/sdk";
+
+const openrouterAdmin = createOpenRouterSDK({
+  tokenSource: getRotatingManagementKey,
+  appName: "My AbsoluteJS App",
+  appUrl: "https://example.com",
+  timeoutMs: 15_000,
+  retryConfig: { strategy: "backoff" },
+});
+
+const keys = await openrouterAdmin.apiKeys.list();
+const guardrails = await openrouterAdmin.guardrails.list();
+const embeddingModels = await openrouterAdmin.embeddings.listModels();
+```
+
+This entry point includes API-key management, BYOK, guardrails and assignments,
+observability destinations, organizations, SCIM, workspaces, public datasets,
+benchmarks, typed pagination, retries, per-call timeouts, and abort signals. It
+tracks compatible patch releases of OpenRouter's generated SDK so new OpenAPI
+fields do not depend on a handwritten AbsoluteJS type update. Normal
+`@absolutejs/ai/openrouter` imports do not load this management surface.
+
 For a strict model-origin policy, also assign an OpenRouter key/workspace
 guardrail with the same model allowlist. Provider allowlists restrict where a
 model runs; they do not identify who developed it. Presets and router aliases
@@ -257,8 +298,7 @@ the request. The raw client is intentionally unopinionated and should be limited
 to trusted server-side administration code. OpenRouter currently documents
 reporting generation feedback through Chatroom and Logs, not through a public
 feedback API, so AbsoluteJS exposes generation IDs/content without inventing an
-unstable endpoint. OpenRouter's official SDK can be used alongside this package
-for specialized organization, SSO, SCIM, and BYOK administration.
+unstable endpoint.
 
 Use `openrouterResponses(config)` when an AbsoluteJS agent should stream through
 OpenRouter's stateless Responses API, or `openrouterMessages(config)` for the

package/dist/ai/index.js

@@ -2850,6 +2850,13 @@ var createOpenRouterClient = (config2) => {
       },
       method: "POST"
     }),
+    chat: (body) => {
+      assertAllowedModelsInValue(body, allowedModels);
+      return request("/chat/completions", {
+        body: { ...body, stream: false },
+        method: "POST"
+      });
+    },
     createPresetFromChatCompletions: (slug, body) => {
       assertAllowedModelsInValue(body, allowedModels);
       return request(`/presets/${encodeURIComponent(slug)}/chat/completions`, { body, method: "POST" });
@@ -2952,6 +2959,7 @@ var createOpenRouterClient = (config2) => {
     getVideo: (id) => request(`/videos/${encodeURIComponent(id)}`),
     getWorkspace: (id) => request(`/workspaces/${encodeURIComponent(id)}`),
     listImageModels: async () => filterModelList(await request("/images/models")),
+    listEmbeddingModels: async () => filterModelList(await request("/embeddings/models")),
     listFiles: (query) => request("/files", {
       query: {
         ...query,
@@ -3223,6 +3231,84 @@ var assertIndirectModels = (value, allowedModels, key = "") => {
       assertIndirectModels(child, allowedModels, childKey);
   }
 };
+var assertIntegerRange = (label, value, minimum, maximum) => {
+  if (value === undefined)
+    return;
+  if (!Number.isInteger(value) || value < minimum || maximum !== undefined && value > maximum)
+    throw new Error(`OpenRouter ${label} must be an integer from ${minimum}${maximum === undefined ? " or greater" : ` to ${maximum}`}`);
+};
+var assertPluginOptions = (plugins) => {
+  for (const plugin of plugins ?? []) {
+    if (plugin.id === "response-healing")
+      throw new Error("OpenRouter response-healing requires a non-streaming request; use createOpenRouterClient().chat()");
+    if (plugin.id === "fusion") {
+      const fusion = plugin;
+      if (fusion.analysis_models && (fusion.analysis_models.length < 1 || fusion.analysis_models.length > 8))
+        throw new Error("OpenRouter Fusion analysis_models must contain 1-8 models");
+      assertIntegerRange("Fusion max_tool_calls", fusion.max_tool_calls, 1, 16);
+    }
+    if (plugin.id === "web") {
+      const web = plugin;
+      assertIntegerRange("web plugin max_results", web.max_results, 1, web.engine === "perplexity" ? 20 : 25);
+      if (web.include_domains?.length && web.exclude_domains?.length && (web.engine === "firecrawl" || web.engine === "parallel" || web.engine === "perplexity"))
+        throw new Error(`OpenRouter ${web.engine} web plugin cannot combine include_domains and exclude_domains`);
+    }
+  }
+};
+var assertServerToolOptions = (tools) => {
+  for (const tool of tools ?? []) {
+    if (tool.type === "openrouter:web_search") {
+      const parameters = tool.parameters;
+      assertIntegerRange("web search max_results", parameters?.max_results, 1, 25);
+      if (parameters?.engine === "perplexity" && (parameters.max_results ?? 0) > 20)
+        throw new Error("OpenRouter Perplexity web search max_results must be at most 20");
+      assertIntegerRange("web search max_characters", parameters?.max_characters, 1, 1e5);
+      assertIntegerRange("web search max_total_results", parameters?.max_total_results, 1);
+    }
+    if (tool.type === "openrouter:web_fetch") {
+      assertIntegerRange("web fetch max_uses", tool.parameters?.max_uses, 1);
+      assertIntegerRange("web fetch max_content_tokens", tool.parameters?.max_content_tokens, 1);
+    }
+    if (tool.type === "openrouter:image_generation") {
+      const compression = tool.parameters?.output_compression;
+      if (compression !== undefined && (!Number.isFinite(compression) || compression < 0 || compression > 100))
+        throw new Error("OpenRouter image generation output_compression must be 0-100");
+    }
+    if (tool.type === "openrouter:subagent") {
+      assertIntegerRange("subagent max_completion_tokens", tool.parameters.max_completion_tokens, 1);
+      assertIntegerRange("subagent max_tool_calls", tool.parameters.max_tool_calls, 1, 25);
+      const temperature = tool.parameters.temperature;
+      if (temperature !== undefined && (!Number.isFinite(temperature) || temperature < 0 || temperature > 2))
+        throw new Error("OpenRouter subagent temperature must be 0-2");
+      assertServerToolOptions(tool.parameters.tools);
+    }
+    if (tool.type === "openrouter:advisor") {
+      assertIntegerRange("advisor max_completion_tokens", tool.parameters?.max_completion_tokens, 1);
+      const temperature = tool.parameters?.temperature;
+      if (temperature !== undefined && (!Number.isFinite(temperature) || temperature < 0 || temperature > 2))
+        throw new Error("OpenRouter advisor temperature must be 0-2");
+    }
+    if (tool.type === "openrouter:fusion") {
+      const analysisModels = tool.parameters?.analysis_models;
+      if (analysisModels && (analysisModels.length < 1 || analysisModels.length > 8))
+        throw new Error("OpenRouter Fusion server tool analysis_models must contain 1-8 models");
+      assertIntegerRange("Fusion server tool max_completion_tokens", tool.parameters?.max_completion_tokens, 1);
+      assertIntegerRange("Fusion server tool max_tool_calls", tool.parameters?.max_tool_calls, 1, 16);
+      const temperature = tool.parameters?.temperature;
+      if (temperature !== undefined && (!Number.isFinite(temperature) || temperature < 0 || temperature > 2))
+        throw new Error("OpenRouter Fusion server tool temperature must be 0-2");
+      assertServerToolOptions(tool.parameters?.tools);
+    }
+    if (tool.type === "openrouter:shell") {
+      assertIntegerRange("shell sleep_after_seconds", tool.parameters?.sleep_after_seconds, 0, 2592000);
+      const environment = tool.parameters?.environment;
+      if (environment?.type === "container_reference" && (environment.container_id.length < 1 || environment.container_id.length > 20))
+        throw new Error("OpenRouter shell container_id must contain 1-20 characters");
+    }
+    if (tool.type === "openrouter:experimental__search_models")
+      assertIntegerRange("model search max_results", tool.parameters?.max_results, 1, 20);
+  }
+};
 var assertRequestOptions = (options, allowedModels, allowedPresets, allowedProviders) => {
   assertAllowedPreset(options.preset, allowedPresets);
   assertRequestRoutingPolicy(options.routing, allowedProviders);
@@ -3242,6 +3328,8 @@ var assertRequestOptions = (options, allowedModels, allowedPresets, allowedProvi
   assertIndirectModels(options.serverTools, allowedModels);
   assertIndirectModels(options.messagesTools, allowedModels);
   assertIndirectModels(options.plugins, allowedModels);
+  assertPluginOptions(options.plugins);
+  assertServerToolOptions(options.serverTools);
   if (options.extraBody) {
     const unsafe = Object.keys(options.extraBody).find((key) => SECURITY_SENSITIVE_EXTRA_BODY_FIELDS.has(key));
     if (unsafe)
@@ -7580,5 +7668,5 @@ export {
   BUILTIN_UI_CARDS
 };
 
-//# debugId=25187F8D2370EC5064756E2164756E21
+//# debugId=1A3329E4751DCFB764756E2164756E21
 //# sourceMappingURL=index.js.map