iris-chatbot 5.3.0 → 5.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iris-chatbot",
-  "version": "5.3.0",
+  "version": "5.3.1",
   "private": false,
   "description": "One-command installer for the Iris project template.",
   "bin": {

package/template/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "iris",
-  "version": "5.3.0",
+  "version": "5.3.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "iris",
-      "version": "5.3.0",
+      "version": "5.3.1",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.72.1",
         "clsx": "^2.1.1",

package/template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iris",
-  "version": "5.3.0",
+  "version": "5.3.1",
   "private": true,
   "description": "One-command installer for the Iris project template.",
   "engines": {

package/template/src/app/api/chat/route.ts

@@ -638,10 +638,103 @@ function normalizeWebSourcesEnabled(value: boolean | undefined): boolean {
   return value !== false;
 }
 
+type WebSearchMode = "off" | "auto" | "required";
+
 function supportsWebSourcesViaOpenAI(connection: RuntimeConnection): boolean {
   return connection.kind === "builtin" && connection.provider === "openai";
 }
 
+function getLastUserMessageText(messages: ChatMessageInput[]): string {
+  return [...messages].reverse().find((message) => message.role === "user")?.content?.trim() ?? "";
+}
+
+function decideWebSearchMode(params: {
+  enabled: boolean;
+  connection: RuntimeConnection;
+  messages: ChatMessageInput[];
+}): WebSearchMode {
+  if (!params.enabled || !supportsWebSourcesViaOpenAI(params.connection)) {
+    return "off";
+  }
+
+  const text = getLastUserMessageText(params.messages).replace(/\s+/g, " ").trim().toLowerCase();
+  if (!text) {
+    return "auto";
+  }
+
+  const disableSearchRequested =
+    /\b(?:no|without|skip)\s+(?:web\s+)?(?:search|browsing|browse|lookup|look up)\b/.test(text) ||
+    /\b(?:don't|do not)\s+(?:web\s+)?(?:search|browse|look up|lookup)\b/.test(text) ||
+    /\boffline only\b/.test(text);
+  if (disableSearchRequested) {
+    return "off";
+  }
+
+  const explicitSearchRequested =
+    /\bsearch(?:\s+the)?\s+web\b/.test(text) ||
+    /\blook(?:\s+it)?\s+up\b/.test(text) ||
+    /\bcheck(?:\s+it)?\s+online\b/.test(text) ||
+    /\bverify(?:\s+it)?\s+online\b/.test(text) ||
+    /\bbrowse(?:\s+the)?\s+web\b/.test(text) ||
+    /\bgoogle\s+(?:it|this)\b/.test(text);
+  if (explicitSearchRequested) {
+    return "required";
+  }
+
+  const asksForSources =
+    /\b(?:source|sources|cite|citation|citations|reference|references|link|links)\b/.test(text);
+  const freshnessSignals =
+    /\b(?:latest|current|currently|today|right now|as of|recent|recently|up[- ]to[- ]date|breaking)\b/.test(
+      text,
+    );
+  const volatileDomainSignals =
+    /\b(?:price|pricing|cost|fee|subscription|per token|rate limit|stock|share price|market cap|forecast|weather|score|standings|odds|election|poll)\b/.test(
+      text,
+    );
+  const leadershipSignals =
+    /\b(?:who is|current)\s+(?:the\s+)?(?:ceo|president|prime minister|governor|mayor)\b/.test(text);
+  const metricSignals =
+    /\b(?:average|median|how many|number of|count|rate|percentage|percent|statistics?|stats?)\b/.test(
+      text,
+    );
+  const metricEntitySignals =
+    /\b(?:users?|people|prompts?|requests?|queries?|api|model|gpt|traffic|revenue|downloads?|adoption|daily|weekly|monthly|yearly|per day|per week|per month)\b/.test(
+      text,
+    );
+
+  if (
+    asksForSources ||
+    freshnessSignals ||
+    volatileDomainSignals ||
+    leadershipSignals ||
+    (metricSignals && metricEntitySignals)
+  ) {
+    return "required";
+  }
+
+  const likelyFactualQuestion =
+    text.includes("?") || /^(?:what|who|when|where|which|how)\b/.test(text);
+  const uncertaintySignals =
+    /\b(?:not sure|unsure|uncertain|verify|double-check|confirm|accurate|accuracy)\b/.test(text);
+  if (likelyFactualQuestion && uncertaintySignals) {
+    return "auto";
+  }
+
+  return "off";
+}
+
+function withWebSearchGuidance(system: string | undefined, mode: WebSearchMode): string | undefined {
+  const trimmed = system?.trim() || "";
+  if (mode === "off") {
+    return trimmed || undefined;
+  }
+  const guidance =
+    mode === "required"
+      ? "Web search is required for this turn. Use web_search before answering and cite the sources you relied on."
+      : "Use web_search when the request depends on current or uncertain facts (pricing, statistics, recency). For stable/general knowledge, answer directly without web_search.";
+  return trimmed ? `${trimmed}\n\n${guidance}` : guidance;
+}
+
 function mergeCitationSources(
   target: Map<string, ProviderCitationSource>,
   sources: ProviderCitationSource[] | undefined,
@@ -2487,6 +2580,7 @@ async function streamPlainChat(params: {
   system?: string;
   messages: ChatMessageInput[];
   enableWebSources: boolean;
+  webSearchMode?: WebSearchMode;
   send: (chunk: ChatStreamChunk) => void;
   signal?: AbortSignal;
 }) {
@@ -2536,20 +2630,30 @@ async function streamPlainChat(params: {
     baseURL: openAIBaseURL,
     defaultHeaders: openAIHeaders,
   });
-  const useWebSources =
-    params.enableWebSources && supportsWebSourcesViaOpenAI(params.connection);
+  const useWebSources = params.enableWebSources && supportsWebSourcesViaOpenAI(params.connection);
+  const webSearchMode: WebSearchMode = useWebSources
+    ? params.webSearchMode === "required"
+      ? "required"
+      : "auto"
+    : "off";
+  const instructions = withWebSearchGuidance(params.system, webSearchMode);
   const response = await client.responses.create(
     {
       model: params.model,
-      instructions: params.system,
+      instructions,
       input: params.messages.map((message) => ({
         type: "message",
         role: message.role,
         content: message.content,
       })),
-      tools: useWebSources ? [{ type: "web_search" }] : undefined,
-      tool_choice: useWebSources ? "auto" : undefined,
-      include: useWebSources ? ["web_search_call.action.sources"] : undefined,
+      tools: webSearchMode !== "off" ? [{ type: "web_search" }] : undefined,
+      tool_choice:
+        webSearchMode === "required"
+          ? "required"
+          : webSearchMode === "auto"
+            ? "auto"
+            : undefined,
+      include: webSearchMode !== "off" ? ["web_search_call.action.sources"] : undefined,
       stream: true,
     },
     { signal: params.signal },
@@ -3003,8 +3107,12 @@ export async function POST(request: Request) {
   }
 
   const webSourcesEnabled = normalizeWebSourcesEnabled(body.enableWebSources);
-  const enableWebSourcesForConnection =
-    webSourcesEnabled && supportsWebSourcesViaOpenAI(connection);
+  const webSearchMode = decideWebSearchMode({
+    enabled: webSourcesEnabled,
+    connection,
+    messages: sanitizedMessages,
+  });
+  const enableWebSourcesForConnection = webSearchMode !== "off";
   const localToolsRequested = normalizeLocalTools(body.localTools);
   const memoryContext = sanitizeMemoryContext(body.memory);
   const requestMeta = sanitizeChatRequestMeta(body.meta);
@@ -3111,6 +3219,7 @@ export async function POST(request: Request) {
           system,
           messages: sanitizedMessages,
           enableWebSources: enableWebSourcesForConnection,
+          webSearchMode,
           send,
           signal: request.signal,
         });