nitrostack 1.0.72 → 1.0.74

package/src/studio/lib/types.ts

@@ -1,26 +1,108 @@
 // NitroStack Studio Type Definitions
 
+// ============================================================================
+// JSON Types - For safe handling of arbitrary JSON data
+// ============================================================================
+
+/**
+ * Primitive JSON values
+ */
+export type JsonPrimitive = string | number | boolean | null;
+
+/**
+ * JSON array type
+ */
+export type JsonArray = JsonValue[];
+
+/**
+ * JSON object type
+ */
+export type JsonObject = { [key: string]: JsonValue };
+
+/**
+ * Any valid JSON value
+ */
+export type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+
+// ============================================================================
+// Schema Types
+// ============================================================================
+
+/**
+ * JSON Schema property definition
+ */
+export interface JsonSchemaProperty {
+  type?: string;
+  description?: string;
+  enum?: JsonValue[];
+  default?: JsonValue;
+  items?: JsonSchemaProperty;
+  properties?: Record<string, JsonSchemaProperty>;
+  required?: string[];
+  additionalProperties?: boolean | JsonSchemaProperty;
+  format?: string;
+  minimum?: number;
+  maximum?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+  [key: string]: JsonValue | undefined;
+}
+
+/**
+ * Tool input schema (JSON Schema format)
+ */
+export interface ToolInputSchema {
+  type: string;
+  properties?: Record<string, JsonSchemaProperty>;
+  required?: string[];
+  additionalProperties?: boolean;
+}
+
+// ============================================================================
+// Tool Types
+// ============================================================================
+
+/**
+ * Tool metadata
+ */
+export interface ToolMeta {
+  'openai/outputTemplate'?: string;
+  'ui/template'?: string;
+  'tool/initial'?: boolean;
+  'tool/examples'?: JsonValue;
+  [key: string]: JsonValue | undefined;
+}
+
+/**
+ * Tool examples
+ */
+export interface ToolExamples {
+  request?: JsonValue;
+  response?: JsonValue;
+}
+
 export interface Tool {
   name: string;
   description?: string;
-  inputSchema?: {
-    type: string;
-    properties?: Record<string, any>;
-    required?: string[];
-  };
-  examples?: {
-    request?: any;
-    response?: any;
-  };
+  inputSchema?: ToolInputSchema;
+  examples?: ToolExamples;
   widget?: {
     route: string;
   };
   outputTemplate?: string;
-  _meta?: {
-    'openai/outputTemplate'?: string;
-    'ui/template'?: string;
-    [key: string]: any;
-  };
+  _meta?: ToolMeta;
+}
+
+// ============================================================================
+// Resource Types
+// ============================================================================
+
+/**
+ * Resource examples
+ */
+export interface ResourceExamples {
+  response?: JsonValue;
 }
 
 export interface Resource {
@@ -28,45 +110,69 @@ export interface Resource {
   uri: string;
   description?: string;
   mimeType?: string;
-  examples?: {
-    response?: any;
-  };
-  _meta?: Record<string, any>;
+  examples?: ResourceExamples;
+  _meta?: Record<string, JsonValue>;
+}
+
+// ============================================================================
+// Prompt Types
+// ============================================================================
+
+export interface PromptArgument {
+  name: string;
+  description?: string;
+  required?: boolean;
 }
 
 export interface Prompt {
   name: string;
   description?: string;
-  arguments?: Array<{
-    name: string;
-    description?: string;
-    required?: boolean;
-  }>;
+  arguments?: PromptArgument[];
 }
 
+// ============================================================================
+// Root Types
+// ============================================================================
+
 export interface Root {
   uri: string;
   name?: string;
 }
 
+// ============================================================================
+// Chat Types
+// ============================================================================
+
+/**
+ * Tool call in a chat message
+ */
+export interface ToolCall {
+  id: string;
+  name: string;
+  arguments: JsonValue;
+  result?: JsonValue;
+}
+
+/**
+ * File attachment in a chat message
+ */
+export interface ChatFile {
+  data: string;
+  type: string;
+  name: string;
+}
+
 export interface ChatMessage {
   role: 'user' | 'assistant' | 'tool' | 'system';
   content: string;
   toolCalls?: ToolCall[];
   toolCallId?: string;
-  file?: {
-    data: string;
-    type: string;
-    name: string;
-  };
+  file?: ChatFile;
 }
 
-export interface ToolCall {
-  id: string;
-  name: string;
-  arguments: any;
-  result?: any;
-}
+// ============================================================================
+// Connection & Health Types
+// ============================================================================
 
 export interface PingResult {
   time: Date;
@@ -83,17 +189,92 @@ export interface HealthCheck {
   status: 'up' | 'down' | 'degraded';
   lastCheck: Date;
   message?: string;
+  details?: JsonObject;
 }
 
+// ============================================================================
+// OAuth Types
+// ============================================================================
+
+/**
+ * OAuth Resource Metadata (RFC 9728)
+ */
+export interface ResourceMetadata {
+  resource: string;
+  authorization_servers: string[];
+  scopes_supported?: string[];
+  bearer_methods_supported?: string[];
+  [key: string]: JsonValue | undefined;
+}
+
+/**
+ * OAuth Authorization Server Metadata (RFC 8414)
+ */
+export interface AuthServerMetadata {
+  issuer: string;
+  authorization_endpoint: string;
+  token_endpoint: string;
+  registration_endpoint?: string;
+  revocation_endpoint?: string;
+  introspection_endpoint?: string;
+  scopes_supported?: string[];
+  response_types_supported?: string[];
+  grant_types_supported?: string[];
+  code_challenge_methods_supported?: string[];
+  [key: string]: JsonValue | undefined;
+}
+
+/**
+ * OAuth Client Registration
+ */
+export interface ClientRegistration {
+  client_id: string;
+  client_secret?: string;
+  redirect_uris: string[];
+  token_endpoint_auth_method?: string;
+  grant_types?: string[];
+  response_types?: string[];
+  [key: string]: JsonValue | undefined;
+}
+
+/**
+ * OAuth Token
+ */
+export interface OAuthToken {
+  access_token: string;
+  token_type: string;
+  expires_in?: number;
+  refresh_token?: string;
+  scope?: string;
+  [key: string]: JsonValue | undefined;
+}
+
+/**
+ * OAuth state for the studio
+ */
 export interface OAuthState {
   authServerUrl: string | null;
-  resourceMetadata: any;
-  authServerMetadata: any;
-  clientRegistration: any;
+  resourceMetadata: ResourceMetadata | null;
+  authServerMetadata: AuthServerMetadata | null;
+  clientRegistration: ClientRegistration | null;
   selectedScopes: string[];
-  currentToken: any;
+  currentToken: OAuthToken | null;
+}
+
+// ============================================================================
+// PKCE Types
+// ============================================================================
+
+export interface PKCEParams {
+  code_verifier: string;
+  code_challenge: string;
+  code_challenge_method: 'S256' | 'plain';
 }
 
+// ============================================================================
+// UI Types
+// ============================================================================
+
 export type TabType =
   | 'tools'
   | 'chat'
@@ -105,3 +286,12 @@ export type TabType =
   | 'sampling'
   | 'roots';
 
+/**
+ * Enlarge modal state
+ */
+export interface EnlargeModalState {
+  open: boolean;
+  type: 'tool' | 'resource' | null;
+  item: Tool | Resource | null;
+}
+

package/src/studio/lib/widget-loader.ts

@@ -46,7 +46,7 @@ export async function loadWidget(uri: string): Promise<{ html: string; isDevMode
   }
 }
 
-export function createWidgetHTML(html: string, data: any): string {
+export function createWidgetHTML(html: string, data: unknown): string {
   const htmlParts = [
     '<!DOCTYPE html>',
     '<html>',
@@ -70,7 +70,7 @@ export function createWidgetHTML(html: string, data: any): string {
   return htmlParts.join('\n');
 }
 
-export function postMessageToWidget(iframe: HTMLIFrameElement, data: any, delay: number = 500) {
+export function postMessageToWidget(iframe: HTMLIFrameElement, data: unknown, delay: number = 500): void {
   iframe.onload = () => {
     setTimeout(() => {
       try {

package/templates/typescript-oauth/src/modules/flights/flights.prompts.ts

@@ -22,33 +22,30 @@ export class FlightPrompts {
         ]
     })
     async flightSearchAssistant(input: any, ctx: ExecutionContext) {
-        const systemPrompt = `You are a professional flight booking assistant with expertise in helping travelers find the best flight options.
+        const systemPrompt = `You are a professional flight booking assistant with expertise in helping travelers find flight information.
+
+⚠️ CRITICAL: Only do what the user specifically asks. Do NOT assume additional steps.
 
 Your capabilities:
+- Search for airports using search_airports tool
 - Search for flights using the search_flights tool
 - Get detailed flight information using get_flight_details tool
-- Search for airports using search_airports tool
-- Explain flight options, pricing, and conditions
-- Help users compare different flight options
-- Provide recommendations based on user preferences
-- Guide users through the booking process
-
-Guidelines:
-1. Always confirm the origin, destination, and dates before searching
-2. Ask about passenger count and cabin class preferences
-3. Explain the differences between flight options clearly
-4. Highlight important details like layovers, total duration, and baggage allowance
-5. Inform users about refund and change policies
-6. Help users understand pricing and what's included
-7. Be proactive in suggesting alternatives if initial search has limited results
-
-BOOKING WORKFLOW:
-When a user wants to book a flight:
+- Help book flights when explicitly requested
+
+**IMPORTANT RULES:**
+1. If user asks about airports, ONLY search airports - do NOT search for flights
+2. If user asks about flights, ONLY search flights - do NOT automatically book
+3. If user asks to book, ONLY then proceed with booking workflow
+4. NEVER chain operations unless user explicitly requests it
+
+**EXAMPLES:**
+- "show me airports in London" → search_airports("London") → show results → STOP
+- "find flights from NYC to LAX" → search_flights → show results → STOP
+- "book this flight" → THEN start booking workflow
+
+BOOKING WORKFLOW (only when user explicitly wants to book):
 1. FIRST, collect ALL passenger information (name, title, gender, date of birth, email, phone)
 2. THEN, call create_order tool with complete passenger details
-   - The system will automatically create a HOLD order (no payment required)
-   - The system will automatically handle passenger ID creation with Duffel
-   - You just need to provide the passenger details in the correct format
 ⚠️ NEVER call create_order without collecting passenger information first!
 ⚠️ All bookings are automatically held - no payment is required at booking time
 
@@ -56,7 +53,7 @@ Current user query: ${input.userQuery}
 
 ${input.context?.previousSearches?.length ? `Previous searches in this conversation:\n${JSON.stringify(input.context.previousSearches, null, 2)}` : ''}
 
-Respond naturally and helpfully to assist the user with their flight booking needs.`;
+Respond to EXACTLY what the user asked - nothing more.`;
 
         return {
             role: 'assistant',

package/dist/cli/build-widgets.mjs

@@ -1,165 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Custom widget bundler for NitroStack
- * 
- * This script bundles Next.js widget pages into single-file HTML documents
- * with all JavaScript and CSS inlined, following OpenAI's widget spec.
- * 
- * Unlike Next.js static export which creates multiple chunk files,
- * this creates truly self-contained single-file widgets.
- */
-
-import * as esbuild from 'esbuild';
-import * as fs from 'fs';
-import * as path from 'path';
-
-const WIDGETS_DIR = path.resolve(process.cwd(), 'src/widgets');
-const APP_DIR = path.join(WIDGETS_DIR, 'app');
-const OUT_DIR = path.join(WIDGETS_DIR, 'out');
-
-console.log('🎨 Building widgets with esbuild...\n');
-
-// Clean output directory
-if (fs.existsSync(OUT_DIR)) {
-  fs.rmSync(OUT_DIR, { recursive: true });
-}
-fs.mkdirSync(OUT_DIR, { recursive: true });
-
-// Find all widget pages
-const widgetPages = [];
-
-function findWidgetPages(dir, basePath = '') {
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    const relativePath = path.join(basePath, entry.name);
-
-    if (entry.isDirectory()) {
-      findWidgetPages(fullPath, relativePath);
-    } else if (entry.name === 'page.tsx' || entry.name === 'page.jsx') {
-      const widgetName = basePath || 'index';
-      widgetPages.push({
-        name: widgetName,
-        entryPoint: fullPath,
-        outputName: widgetName.replace(/\//g, '-')
-      });
-    }
-  }
-}
-
-if (fs.existsSync(APP_DIR)) {
-  findWidgetPages(APP_DIR);
-}
-
-console.log(`Found ${widgetPages.length} widget(s):`);
-widgetPages.forEach(w => console.log(`  - ${w.name}`));
-console.log('');
-
-// Bundle each widget
-for (const widget of widgetPages) {
-  console.log(`📦 Bundling ${widget.name}...`);
-
-  const tempEntry = path.join(OUT_DIR, `_temp_${widget.outputName}.jsx`);
-  const jsOutput = path.join(OUT_DIR, `${widget.outputName}.js`);
-  const htmlOutput = path.join(OUT_DIR, `${widget.outputName}.html`);
-
-  // Create a temporary entry file that renders the widget
-  const entryCode = `
-import React from 'react';
-import { createRoot } from 'react-dom/client';
-import WidgetPage from '${widget.entryPoint.replace(/\\/g, '/')}';
-
-// Wait for DOM to be ready
-if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', init);
-} else {
-  init();
-}
-
-function init() {
-  // Get data from window.openai if available
-  const data = window.openai?.toolOutput || {};
-  
-  // Find or create root element
-  let root = document.getElementById('widget-root');
-  if (!root) {
-    root = document.createElement('div');
-    root.id = 'widget-root';
-    document.body.appendChild(root);
-  }
-  
-  // Render the widget
-  const reactRoot = createRoot(root);
-  reactRoot.render(React.createElement(WidgetPage, { data }));
-}
-`;
-
-  fs.writeFileSync(tempEntry, entryCode);
-
-  try {
-    // Bundle with esbuild
-    await esbuild.build({
-      entryPoints: [tempEntry],
-      bundle: true,
-      format: 'iife',
-      outfile: jsOutput,
-      platform: 'browser',
-      target: ['es2020'],
-      minify: true,
-      jsx: 'automatic',
-      jsxImportSource: 'react',
-      // Don't bundle React - it should come from widgets/node_modules
-      external: [],
-      // Resolve modules from the widgets directory
-      nodePaths: [path.join(WIDGETS_DIR, 'node_modules')],
-      define: {
-        'process.env.NODE_ENV': '"production"'
-      },
-      logLevel: 'warning'
-    });
-
-    // Read the bundled JavaScript
-    const bundledJs = fs.readFileSync(jsOutput, 'utf-8');
-
-    // Create the HTML file with inlined JavaScript
-    const html = `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <style>
-    * { box-sizing: border-box; }
-    body { 
-      margin: 0; 
-      padding: 0; 
-      font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-    }
-    #widget-root {
-      width: 100%;
-      min-height: 100vh;
-    }
-  </style>
-</head>
-<body>
-  <div id="widget-root"></div>
-  <script>${bundledJs}</script>
-</body>
-</html>`;
-
-    fs.writeFileSync(htmlOutput, html);
-
-    // Clean up temporary files
-    fs.unlinkSync(tempEntry);
-    fs.unlinkSync(jsOutput);
-
-    console.log(`  ✓ ${widget.outputName}.html`);
-
-  } catch (error) {
-    console.error(`  ✗ Failed to bundle ${widget.name}:`, error.message);
-    process.exit(1);
-  }
-}
-
-console.log(`\n✨ Successfully built ${widgetPages.length} widget(s) to ${OUT_DIR}\n`);