nitrostack 1.0.71 → 1.0.73

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 {