@x12i/openrouter-runtime 1.0.4 → 1.0.6

package/dist/index.d.ts

@@ -3,7 +3,11 @@ type ResolvedApiMode = "chat" | "responses";
 type ToolMode = "disabled" | "allowed" | "required";
 interface OpenRouterRuntime {
     run(request: RuntimeRequest): Promise<RuntimeResponse>;
-    stream?(request: RuntimeRequest): AsyncIterable<RuntimeStreamEvent>;
+    /**
+     * Streaming chat entrypoint. Separate from `run()` by design.
+     * The old `stream()` name was removed so mistaken/old clients break loudly.
+     */
+    executeStreamingChat(request: RuntimeRequest): AsyncIterable<RuntimeStreamEvent>;
 }
 interface OpenRouterRuntimeOptions {
     apiKey?: string;
@@ -367,7 +371,20 @@ type RuntimePatchApplier = (patch: RuntimePatchProposal) => Promise<unknown> | u
 
 declare function createOpenRouterRuntime(options: OpenRouterRuntimeOptions): OpenRouterRuntime;
 
-declare function compileRuntimeRequest(request: RuntimeRequest, defaults: RuntimeDefaults, options?: OpenRouterRuntimeOptions): CompiledOpenRouterRequest;
+interface RuntimeCompileContext {
+    streaming: boolean;
+}
+interface OpenRouterTool {
+    type: string;
+    function?: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+    parameters?: Record<string, unknown>;
+}
+
+declare function compileRuntimeRequest(request: RuntimeRequest, defaults: RuntimeDefaults, options?: OpenRouterRuntimeOptions, context?: Partial<RuntimeCompileContext>): CompiledOpenRouterRequest;
 
 declare class RuntimeConfigError extends Error {
     readonly code: string;
@@ -392,16 +409,9 @@ declare class OpenRouterHttpError extends Error {
     constructor(status: number, code: ProviderFailureCode, message: string, body?: unknown | undefined, retryable?: boolean, providerAttempts?: ProviderAttemptError[]);
 }
 
-interface OpenRouterTool {
-    type: string;
-    function?: {
-        name: string;
-        description: string;
-        parameters: Record<string, unknown>;
-    };
-    parameters?: Record<string, unknown>;
-}
-
 declare function buildOpenRouterServerTools(policy?: RuntimeServerToolsPolicy): OpenRouterTool[];
 
-export { type AdvisorPolicy, type ApplyPatchPolicy, type CompiledOpenRouterRequest, type DatetimePolicy, type FusionPolicy, type ImageGenerationPolicy, OpenRouterHttpError, type OpenRouterRuntime, type OpenRouterRuntimeOptions, type RuntimeCitation, RuntimeConfigError, type RuntimeDefaults, type RuntimeError, type RuntimeFunctionToolDefinition, type RuntimeGeneratedImage, type RuntimeMessage, type RuntimePatchProposal, type RuntimePolicyViolation, type RuntimeRequest, type RuntimeResponse, type RuntimeServerToolsPolicy, type RuntimeToolExecutor, type RuntimeToolUsage, type RuntimeUsage, type RuntimeWarning, type ServerToolKey, type ServerToolUsage, type SubagentPolicy, type WebFetchPolicy, type WebSearchPolicy, buildOpenRouterServerTools, compileRuntimeRequest, createOpenRouterRuntime };
+declare function isRuntimeLoggingEnabled(env?: Record<string, string | undefined> | undefined): boolean;
+declare function createConsoleLogger(): RuntimeLogger;
+
+export { type AdvisorPolicy, type ApplyPatchPolicy, type CompiledOpenRouterRequest, type DatetimePolicy, type FusionPolicy, type ImageGenerationPolicy, OpenRouterHttpError, type OpenRouterRuntime, type OpenRouterRuntimeOptions, type RuntimeCitation, RuntimeConfigError, type RuntimeDefaults, type RuntimeError, type RuntimeFunctionToolDefinition, type RuntimeGeneratedImage, type RuntimeLogger, type RuntimeMessage, type RuntimePatchProposal, type RuntimePolicyViolation, type RuntimeRequest, type RuntimeResponse, type RuntimeServerToolsPolicy, type RuntimeStreamEvent, type RuntimeToolExecutor, type RuntimeToolUsage, type RuntimeUsage, type RuntimeWarning, type ServerToolKey, type ServerToolUsage, type SubagentPolicy, type WebFetchPolicy, type WebSearchPolicy, buildOpenRouterServerTools, compileRuntimeRequest, createConsoleLogger, createOpenRouterRuntime, isRuntimeLoggingEnabled };

package/dist/index.js

@@ -1,11 +1,36 @@
+// src/utils/console-logger.ts
+var TRUTHY = /* @__PURE__ */ new Set(["1", "true", "yes", "on"]);
+function isRuntimeLoggingEnabled(env = typeof process === "undefined" ? void 0 : process.env) {
+  const value = env?.OPENROUTER_RUNTIME_LOGS?.trim().toLowerCase();
+  return value !== void 0 && TRUTHY.has(value);
+}
+function createConsoleLogger() {
+  return {
+    debug(event, data) {
+      console.debug(`[openrouter-runtime] ${event}`, data ?? "");
+    },
+    info(event, data) {
+      console.info(`[openrouter-runtime] ${event}`, data ?? "");
+    },
+    warn(event, data) {
+      console.warn(`[openrouter-runtime] ${event}`, data ?? "");
+    },
+    error(event, data) {
+      console.error(`[openrouter-runtime] ${event}`, data ?? "");
+    }
+  };
+}
+
 // src/config/defaults.ts
 function resolveRuntimeOptions(options) {
+  const logger = options.logger ?? (isRuntimeLoggingEnabled() ? createConsoleLogger() : void 0);
   return {
     ...options,
     apiKey: options.apiKey ?? readOpenRouterApiKeyFromEnv() ?? "",
     baseUrl: options.baseUrl ?? "https://openrouter.ai/api/v1",
     defaultHeaders: options.defaultHeaders ?? {},
-    fetch: options.fetch ?? globalThis.fetch
+    fetch: options.fetch ?? globalThis.fetch,
+    ...logger ? { logger } : {}
   };
 }
 function resolveDefaults(options) {
@@ -860,8 +885,9 @@ function buildSubagentTool(policy) {
 }
 
 // src/runtime/runtime.ts
-function compileRuntimeRequest(request, defaults, options = { apiKey: "" }) {
+function compileRuntimeRequest(request, defaults, options = { apiKey: "" }, context = {}) {
   const warnings = [];
+  const effectiveContext = { streaming: false, ...context };
   const requestedModel = request.model ?? options.defaultModel ?? "";
   const normalized = normalizeModel(requestedModel);
   warnings.push(...normalized.warnings);
@@ -882,6 +908,7 @@ function compileRuntimeRequest(request, defaults, options = { apiKey: "" }) {
   const headers = buildHeaders(options);
   const baseBody = buildBaseBody(request, normalized.model, defaults, tools, serverTools);
   const body = apiMode === "chat" ? buildChatBody(request, baseBody) : buildResponsesBody(request, baseBody);
+  enforceStreamingPolicyForRun(body, warnings, effectiveContext);
   return {
     apiMode,
     url: endpointFor(options.baseUrl ?? "https://openrouter.ai/api/v1", apiMode),
@@ -890,6 +917,41 @@ function compileRuntimeRequest(request, defaults, options = { apiKey: "" }) {
     warnings
   };
 }
+function enforceStreamingPolicyForRun(body, warnings, context) {
+  if (context.streaming) return;
+  if (body.stream !== void 0 && body.stream !== false) {
+    warnings.push({
+      code: "STREAMING_OVERRIDE_IGNORED_FOR_RUN",
+      message: "runtime.run() is non-streaming. Use runtime.executeStreamingChat() when streaming is implemented.",
+      details: { ignoredStreamValue: body.stream }
+    });
+  }
+  body.stream = false;
+  stripAdvisorStreaming(body, warnings);
+}
+function stripAdvisorStreaming(body, warnings) {
+  const tools = body.tools;
+  if (!Array.isArray(tools)) return;
+  let stripped = 0;
+  for (const tool of tools) {
+    if (!tool || typeof tool !== "object") continue;
+    const record = tool;
+    if (record.type !== "openrouter:advisor") continue;
+    const parameters = record.parameters;
+    if (!parameters || typeof parameters !== "object") continue;
+    const params = parameters;
+    if (params.stream === void 0 || params.stream === false) continue;
+    params.stream = false;
+    stripped += 1;
+  }
+  if (stripped > 0) {
+    warnings.push({
+      code: "ADVISOR_STREAMING_IGNORED_FOR_RUN",
+      message: "runtime.run() disables advisor.stream. Nested advisor streaming is not supported on the non-streaming entrypoint.",
+      details: { advisorsStripped: stripped }
+    });
+  }
+}
 function resolveApiMode(request, defaultMode = "auto", serverTools) {
   const mode = request.apiMode ?? defaultMode;
   if (mode === "chat") return "chat";
@@ -922,7 +984,7 @@ function buildChatBody(request, baseBody) {
   return clean({
     ...baseBody,
     messages,
-    max_tokens: request.maxTokens,
+    max_completion_tokens: request.maxTokens,
     response_format: request.responseFormat
   });
 }
@@ -1263,6 +1325,14 @@ function optional6(key, value) {
   return value === void 0 ? {} : { [key]: value };
 }
 
+// src/runtime/streaming.ts
+async function* executeStreamingChatNotImplemented() {
+  throw new RuntimeConfigError(
+    "STREAMING_NOT_IMPLEMENTED",
+    "executeStreamingChat() is reserved and not implemented yet. Use runtime.run() for non-streaming execution."
+  );
+}
+
 // src/runtime/create-runtime.ts
 function createOpenRouterRuntime(options) {
   const resolvedOptions = resolveRuntimeOptions(options);
@@ -1272,22 +1342,42 @@ function createOpenRouterRuntime(options) {
     async run(request) {
       const requestWithId = { ...request, id: request.id ?? createRuntimeId() };
       try {
-        resolvedOptions.logger?.info?.("runtime.request.started", { requestId: requestWithId.id });
+        resolvedOptions.logger?.info?.("runtime.request.started", {
+          requestId: requestWithId.id,
+          streaming: false,
+          entrypoint: "run"
+        });
         await resolvedOptions.hooks?.beforeCompile?.(requestWithId);
-        const compiled = compileRuntimeRequest(requestWithId, defaults, resolvedOptions);
+        const compiled = compileRuntimeRequest(requestWithId, defaults, resolvedOptions, { streaming: false });
         await resolvedOptions.hooks?.afterCompile?.(compiled);
         resolvedOptions.logger?.debug?.("runtime.request.compiled", {
           requestId: requestWithId.id,
-          apiMode: compiled.apiMode
+          apiMode: compiled.apiMode,
+          streaming: false,
+          bodyStream: compiled.body.stream,
+          streamingWarnings: compiled.warnings.filter((warning) => warning.code.includes("STREAMING") || warning.code.includes("ADVISOR_STREAMING")).map((warning) => warning.code)
         });
         await resolvedOptions.hooks?.beforeOpenRouterRequest?.(compiled);
         const response = compiled.apiMode === "chat" ? await runChat(requestWithId, compiled, context) : await runResponses(requestWithId, compiled, context);
         await resolvedOptions.hooks?.afterOpenRouterResponse?.(response.raw.response);
-        resolvedOptions.logger?.info?.("runtime.response.normalized", { requestId: requestWithId.id, status: response.status });
+        resolvedOptions.logger?.info?.("runtime.response.normalized", {
+          requestId: requestWithId.id,
+          status: response.status,
+          streaming: false
+        });
         return response;
       } catch (error) {
         return errorResponse(requestWithId, error);
       }
+    },
+    executeStreamingChat(request) {
+      resolvedOptions.logger?.warn?.("runtime.executeStreamingChat.called", {
+        requestId: request.id,
+        streaming: true,
+        entrypoint: "executeStreamingChat",
+        implemented: false
+      });
+      return executeStreamingChatNotImplemented();
     }
   };
   function errorResponse(request, error) {
@@ -1380,6 +1470,8 @@ export {
   RuntimeConfigError,
   buildOpenRouterServerTools,
   compileRuntimeRequest,
-  createOpenRouterRuntime
+  createConsoleLogger,
+  createOpenRouterRuntime,
+  isRuntimeLoggingEnabled
 };
 //# sourceMappingURL=index.js.map