insforge 1.3.0 → 1.4.8

package/openapi/ai.yaml

@@ -405,7 +405,7 @@ components:
           example: openai/gpt-4
         messages:
           type: array
-          description: Array of messages for conversation
+          description: Array of messages for conversation (supports text, images, audio, and files/PDFs)
           items:
             $ref: '#/components/schemas/ChatMessage'
         stream:
@@ -428,15 +428,25 @@ components:
         systemPrompt:
           type: string
           description: System prompt to guide model behavior
+        webSearch:
+          $ref: '#/components/schemas/WebSearchPlugin'
+        fileParser:
+          $ref: '#/components/schemas/FileParserPlugin'
+        thinking:
+          type: boolean
+          description: Enable extended reasoning capabilities (appends :thinking to model ID if not already present). Not every model supports this, only works with Anthropic models with the :thinking suffix.
 
     ChatCompletionResponse:
       type: object
       properties:
-        success:
-          type: boolean
-        content:
+        text:
           type: string
-          description: AI model response
+          description: AI model response content
+        annotations:
+          type: array
+          description: URL citations from web search results (present when webSearch is enabled)
+          items:
+            $ref: '#/components/schemas/UrlCitationAnnotation'
         metadata:
           type: object
           properties:
@@ -455,6 +465,106 @@ components:
         totalTokens:
           type: integer
 
+    WebSearchPlugin:
+      type: object
+      required:
+        - enabled
+      properties:
+        enabled:
+          type: boolean
+          description: Enable web search integration
+        engine:
+          type: string
+          enum: [native, exa]
+          description: |
+            Search engine selection:
+            - native: Use provider's built-in web search (OpenAI, Anthropic, Perplexity, xAI)
+            - exa: Use Exa's search API
+            - undefined: Auto-select (native if available, otherwise Exa)
+        maxResults:
+          type: integer
+          minimum: 1
+          maximum: 10
+          default: 5
+          description: Maximum number of search results to include
+        searchPrompt:
+          type: string
+          description: Custom prompt for attaching search results to the message
+
+    FileParserPlugin:
+      type: object
+      required:
+        - enabled
+      properties:
+        enabled:
+          type: boolean
+          description: Enable file parsing for PDFs in messages
+        pdf:
+          type: object
+          properties:
+            engine:
+              type: string
+              enum: [pdf-text, mistral-ocr, native]
+              description: |
+                PDF processing engine:
+                - pdf-text: Best for well-structured PDFs with clear text content (Free)
+                - mistral-ocr: Best for scanned documents or PDFs with images ($2 per 1,000 pages)
+                - native: Only for models with native file support (charged as input tokens)
+                If not specified, defaults to native if available, otherwise mistral-ocr
+
+    FileContent:
+      type: object
+      description: File content for PDFs and other documents
+      required:
+        - type
+        - file
+      properties:
+        type:
+          type: string
+          enum: [file]
+        file:
+          type: object
+          required:
+            - filename
+            - file_data
+          properties:
+            filename:
+              type: string
+              description: Filename with extension (e.g., "document.pdf")
+              example: document.pdf
+            file_data:
+              type: string
+              description: |
+                File data can be:
+                - Public URL: "https://example.com/document.pdf"
+                - Base64 data URL: "data:application/pdf;base64,..."
+              example: "https://example.com/document.pdf"
+
+    UrlCitationAnnotation:
+      type: object
+      properties:
+        type:
+          type: string
+          enum: [url_citation]
+        urlCitation:
+          type: object
+          properties:
+            url:
+              type: string
+              description: URL of the cited source
+            title:
+              type: string
+              description: Title of the cited page
+            content:
+              type: string
+              description: Relevant content snippet from the source
+            startIndex:
+              type: integer
+              description: Start character index in response text where citation applies
+            endIndex:
+              type: integer
+              description: End character index in response text where citation applies
+
     ImageGenerationOptions:
       type: object
       required:

package/openapi/auth.yaml

@@ -26,7 +26,7 @@ paths:
                       properties:
                         provider:
                           type: string
-                          enum: [google, github, discord, linkedin, facebook, microsoft]
+                          enum: [google, github, discord, linkedin, facebook, instagram, tiktok, apple, x, spotify, microsoft]
                         useSharedKey:
                           type: boolean
                   requireEmailVerification:
@@ -60,6 +60,71 @@ paths:
                     enum: [code, link]
                     description: Method for password reset (code = 6-digit OTP + exchange flow, link = magic link)
 
+  /api/auth/profiles/current:
+    patch:
+      summary: Update current user's profile
+      description: Update the profile of the currently authenticated user
+      tags:
+        - Client
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - profile
+              properties:
+                profile:
+                  type: object
+                  additionalProperties: true
+                  description: Profile data (name, avatar_url, and any custom fields)
+                  properties:
+                    name:
+                      type: string
+                    avatar_url:
+                      type: string
+                      format: uri
+      responses:
+        '200':
+          description: Profile updated successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProfileResponse'
+        '400':
+          description: Invalid request
+        '401':
+          description: Unauthorized - authentication required
+
+  /api/auth/profiles/{userId}:
+    get:
+      summary: Get user profile by ID
+      description: Get public profile information for a user by their ID (public endpoint)
+      tags:
+        - Client
+      parameters:
+        - name: userId
+          in: path
+          required: true
+          schema:
+            type: string
+            format: uuid
+          description: User ID
+      responses:
+        '200':
+          description: User profile
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProfileResponse'
+        '400':
+          description: Invalid user ID format
+        '404':
+          description: User not found
+
   /api/auth/config:
     get:
       summary: Get authentication configuration
@@ -847,7 +912,7 @@ paths:
               properties:
                 provider:
                   type: string
-                  enum: [google, github, discord, linkedin, facebook, microsoft]
+                  enum: [google, github, discord, linkedin, facebook, instagram, tiktok, apple, x, spotify, microsoft]
                 clientId:
                   type: string
                 clientSecret:
@@ -888,7 +953,7 @@ paths:
           required: true
           schema:
             type: string
-            enum: [google, github, discord, linkedin, facebook, microsoft]
+            enum: [google, github, discord, linkedin, facebook, instagram, tiktok, apple, x, spotify, microsoft]
       responses:
         '200':
           description: OAuth configuration
@@ -921,7 +986,7 @@ paths:
           required: true
           schema:
             type: string
-            enum: [google, github, discord, linkedin, facebook, microsoft]
+            enum: [google, github, discord, linkedin, facebook, instagram, tiktok, apple, x, spotify, microsoft]
       requestBody:
         required: true
         content:
@@ -970,7 +1035,7 @@ paths:
           required: true
           schema:
             type: string
-            enum: [google, github, discord, linkedin, facebook, microsoft]
+            enum: [google, github, discord, linkedin, facebook, instagram, tiktok, apple, x, spotify, microsoft]
       responses:
         '200':
           description: Configuration deleted
@@ -1002,7 +1067,7 @@ paths:
           required: true
           schema:
             type: string
-            enum: [google, github, discord, linkedin, facebook, microsoft]
+            enum: [google, github, discord, linkedin, facebook, instagram, tiktok, apple, x, spotify, microsoft]
         - name: redirect_uri
           in: query
           required: true
@@ -1075,7 +1140,7 @@ paths:
           required: true
           schema:
             type: string
-            enum: [google, github, discord, linkedin, facebook, microsoft]
+            enum: [google, github, discord, linkedin, facebook, instagram, tiktok, apple, x, spotify, microsoft]
         - name: code
           in: query
           schema:
@@ -1123,19 +1188,15 @@ components:
         email:
           type: string
           format: email
-        name:
-          type: string
+        metadata:
+          type: object
+          additionalProperties: true
         emailVerified:
           type: boolean
-        identities:
+        providers:
           type: array
           items:
-            type: object
-            properties:
-              provider:
-                type: string
-        providerType:
-          type: string
+            type: string
         createdAt:
           type: string
           format: date-time
@@ -1143,6 +1204,25 @@ components:
           type: string
           format: date-time
 
+    ProfileResponse:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+          description: User ID
+        profile:
+          type: object
+          nullable: true
+          additionalProperties: true
+          description: User profile data (can contain custom fields)
+          properties:
+            name:
+              type: string
+            avatar_url:
+              type: string
+              format: uri
+
     OAuthConfig:
       type: object
       properties:
@@ -1151,7 +1231,7 @@ components:
           format: uuid
         provider:
           type: string
-          enum: [google, github, discord, linkedin, facebook, microsoft]
+          enum: [google, github, discord, linkedin, facebook, instagram, tiktok, apple, x, spotify, microsoft]
         clientId:
           type: string
           nullable: true

package/openapi/logs.yaml

@@ -189,8 +189,6 @@ paths:
                 tableStats:
                   - table_name: "posts"
                     count: 156
-                  - table_name: "users"
-                    count: 89
                   - table_name: "comments"
                     count: 223
                 recentActivity: 47

package/openapi/metadata.yaml

@@ -92,8 +92,6 @@ paths:
                     format: date-time
               example:
                 tables:
-                  - name: "users"
-                    recordCount: 1234
                   - name: "posts"
                     recordCount: 5678
                   - name: "comments"

package/openapi/records.yaml

@@ -21,7 +21,7 @@ paths:
           schema:
             type: string
           description: Name of the table to query
-          example: users
+          example: posts
         - name: limit
           in: query
           schema:
@@ -48,7 +48,7 @@ paths:
           schema:
             type: string
           description: Comma-separated list of columns to return
-          example: id,name,email
+          example: id,title,content
         # PostgREST-style filters
         - name: field
           in: query
@@ -77,13 +77,13 @@ paths:
                   additionalProperties: true
               example:
                 - id: "248373e1-0aea-45ce-8844-5ef259203749"
-                  name: "John Doe"
-                  email: "john@example.com"
+                  title: "Getting Started with InsForge"
+                  content: "This is a guide to help you get started..."
                   createdAt: "2025-07-18T05:37:24.338Z"
                   updatedAt: "2025-07-18T05:37:24.338Z"
                 - id: "348373e1-0aea-45ce-8844-5ef259203750"
-                  name: "Jane Smith"
-                  email: "jane@example.com"
+                  title: "Advanced Database Queries"
+                  content: "Learn how to write complex queries..."
                   createdAt: "2025-07-19T08:15:10.123Z"
                   updatedAt: "2025-07-19T08:15:10.123Z"
         '404':
@@ -124,7 +124,7 @@ paths:
           schema:
             type: string
           description: Name of the table
-          example: users
+          example: posts
         - name: Prefer
           in: header
           schema:
@@ -142,9 +142,9 @@ paths:
                 additionalProperties: true
               minItems: 1
             example:
-              - name: "John Doe"
-                email: "john@example.com"
-                age: 30
+              - title: "My First Post"
+                content: "Hello world! This is my first post."
+                published: true
       responses:
         '201':
           description: Records created
@@ -163,9 +163,9 @@ paths:
                   summary: "Response with Prefer: return=representation"
                   value:
                     - id: "248373e1-0aea-45ce-8844-5ef259203749"
-                      name: "John Doe"
-                      email: "john@example.com"
-                      age: 30
+                      title: "My First Post"
+                      content: "Hello world! This is my first post."
+                      published: true
                       createdAt: "2025-07-18T05:37:24.338Z"
                       updatedAt: "2025-07-18T05:37:24.338Z"
         '400':
@@ -176,7 +176,7 @@ paths:
                 $ref: '#/components/schemas/ErrorResponse'
               example:
                 error: "VALIDATION_ERROR"
-                message: "Invalid field type: expected integer for 'age'"
+                message: "Invalid field type: expected boolean for 'published'"
                 statusCode: 400
                 nextActions: "Ensure field types match the table schema"
         '404':
@@ -206,7 +206,7 @@ paths:
           schema:
             type: string
           description: Name of the table
-          example: users
+          example: posts
         - name: id
           in: query
           schema:
@@ -227,8 +227,8 @@ paths:
               type: object
               additionalProperties: true
             example:
-              name: "Jane Doe"
-              email: "jane.doe@example.com"
+              title: "Updated Post Title"
+              content: "This content has been updated."
       responses:
         '200':
           description: Records updated
@@ -247,8 +247,8 @@ paths:
                   summary: "Response with Prefer: return=representation"
                   value:
                     - id: "123e4567-e89b-12d3-a456-426614174000"
-                      name: "Jane Doe"
-                      email: "jane.doe@example.com"
+                      title: "Updated Post Title"
+                      content: "This content has been updated."
                       createdAt: "2025-01-01T00:00:00Z"
                       updatedAt: "2025-01-21T11:00:00Z"
         '404':
@@ -287,7 +287,7 @@ paths:
           schema:
             type: string
           description: Name of the table
-          example: users
+          example: posts
         - name: id
           in: query
           schema:
@@ -317,7 +317,7 @@ paths:
                   summary: Records were deleted
                   value:
                     - id: "123e4567-e89b-12d3-a456-426614174000"
-                      name: "Deleted User"
+                      title: "Deleted Post"
                       createdAt: "2025-01-01T00:00:00Z"
                       updatedAt: "2025-01-21T11:00:00Z"
                 no_records:

package/openapi/tables.yaml

@@ -22,7 +22,6 @@ paths:
                 items:
                   type: string
               example:
-                - "users"
                 - "posts"
                 - "comments"
                 - "categories"
@@ -191,7 +190,7 @@ paths:
                     default: null
                     isPrimaryKey: false
                     foreignKey:
-                      table: "users"
+                      table: "auth.users"
                       column: "id"
                       on_delete: "CASCADE"
         '404':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "insforge",
-  "version": "1.3.0",
+  "version": "1.4.8",
   "description": "InsForge - Open source backend-as-a-service with PostgreSQL and MCP integration",
   "type": "module",
   "workspaces": [

package/shared-schemas/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insforge/shared-schemas",
-  "version": "1.1.33",
+  "version": "1.1.40",
   "author": "Insforge",
   "description": "Shared TypeScript schemas for InsForge frontend and backend",
   "license": "Apache-2.0",