@proveanything/smartlinks 1.7.5 → 1.7.8

package/openapi.yaml

@@ -7,13 +7,14 @@ servers:
   - url: "https://smartlinks.app/api/v1"
     description: Production
 tags:
+  - name: responses
   - name: completions
   - name: models
   - name: rag
   - name: sessions
   - name: podcast
   - name: tts
-  - name: publicApi
+  - name: publicClient
   - name: voice
   - name: userAppData
   - name: appConfiguration
@@ -691,7 +692,7 @@ paths:
     post:
       tags:
         - rag
-      summary: "List available AI models / export async function list(collectionId: string): Promise<{ object: 'list'; data: AIModel[] }"
+      summary: "List available AI models / export async function list(collectionId: string, params?: AIModelListParams): Promise<AIModel"
       operationId: rag_indexDocument
       security:
         - bearerAuth: []
@@ -720,11 +721,38 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/IndexDocumentRequest"
+  /admin/collection/{collectionId}/ai/models)}:
+    get:
+      tags:
+        - models
+      summary: List available AI models
+      operationId: models_list
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AIModelListResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/ai/models/{modelId}:
     get:
       tags:
         - models
-      summary: "List available AI models / export async function list(collectionId: string): Promise<{ object: 'list'; data: AIModel[] }"
+      summary: "List available AI models / export async function list(collectionId: string, params?: AIModelListParams): Promise<AIModel"
       operationId: models_get
       security:
         - bearerAuth: []
@@ -938,6 +966,39 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/ChatCompletionRequest"
+  /admin/collection/{collectionId}/ai/v1/responses:
+    post:
+      tags:
+        - responses
+      summary: Create a Responses API request (streaming or non-streaming)
+      operationId: responses_create
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ResponsesResult"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ResponsesRequest"
   /admin/collection/{collectionId}/assignSN/{codeId}:
     post:
       tags:
@@ -4132,75 +4193,11 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/TimelineRequest"
-  /admin/collection/{collectionId}/orders/batch/{batchId}:
-    get:
-      tags:
-        - order
-      summary: Find all orders containing items from a specific batch.
-      operationId: order_findByBatch
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: batchId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/FindOrdersByAttributeResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-  /admin/collection/{collectionId}/orders/batch/{batchId}/items:
-    get:
-      tags:
-        - order
-      summary: Get individual order items (not full orders) for a specific batch.
-      operationId: order_findItemsByBatch
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: batchId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/FindItemsByAttributeResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
   /admin/collection/{collectionId}/orders/ids/{attribute}/{value}:
     get:
       tags:
         - order
-      summary: order.getOrderIdsByAttribute
+      summary: Get unique order IDs containing items for a specific product.
       operationId: order_getOrderIdsByAttribute
       security:
         - bearerAuth: []
@@ -4390,70 +4387,6 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/orders/variant/{variantId}:
-    get:
-      tags:
-        - order
-      summary: Find all orders containing items from a specific variant.
-      operationId: order_findByVariant
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: variantId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/FindOrdersByAttributeResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-  /admin/collection/{collectionId}/orders/variant/{variantId}/items:
-    get:
-      tags:
-        - order
-      summary: Get individual order items for a specific variant.
-      operationId: order_findItemsByVariant
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: variantId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/FindItemsByAttributeResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
   /admin/collection/{collectionId}/orders/{orderId}:
     get:
       tags:
@@ -6999,9 +6932,9 @@ paths:
   /public/collection/{collectionId}/ai/chat:
     post:
       tags:
-        - publicApi
+        - publicClient
       summary: "Generate text-to-speech audio / export async function generate( collectionId: string, request: TTSRequest ): Promise<Blo"
-      operationId: publicApi_chat
+      operationId: publicClient_chat
       security: []
       parameters:
         - name: collectionId
@@ -7031,9 +6964,9 @@ paths:
   /public/collection/{collectionId}/ai/rate-limit/{userId}:
     get:
       tags:
-        - publicApi
+        - publicClient
       summary: "Get session history / export async function getSession(collectionId: string, sessionId: string): Promise<Session> { cons"
-      operationId: publicApi_getRateLimit
+      operationId: publicClient_getRateLimit
       security: []
       parameters:
         - name: collectionId
@@ -7062,9 +6995,9 @@ paths:
   /public/collection/{collectionId}/ai/session/{sessionId}:
     get:
       tags:
-        - publicApi
+        - publicClient
       summary: "Chat with product assistant (RAG) / export async function chat( collectionId: string, request: PublicChatRequest ): Prom"
-      operationId: publicApi_getSession
+      operationId: publicClient_getSession
       security: []
       parameters:
         - name: collectionId
@@ -7093,9 +7026,9 @@ paths:
   /public/collection/{collectionId}/ai/token:
     post:
       tags:
-        - publicApi
+        - publicClient
       summary: "Clear session history / export async function clearSession(collectionId: string, sessionId: string): Promise<{ success:"
-      operationId: publicApi_getToken
+      operationId: publicClient_getToken
       security: []
       parameters:
         - name: collectionId
@@ -9828,8 +9761,9 @@ components:
         id:
           type: string
         type:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - function
         function:
           type: object
           additionalProperties: true
@@ -9907,6 +9841,177 @@ components:
         - type
         - properties
         - type
+    ResponseTool:
+      type: object
+      properties:
+        type:
+          type: string
+        name:
+          type: string
+        description:
+          type: string
+        parameters:
+          type: object
+          additionalProperties: true
+      required:
+        - type
+    ResponseInputItem:
+      type: object
+      properties:
+        role:
+          type: string
+          enum:
+            - system
+            - user
+            - assistant
+            - function
+            - tool
+        type:
+          type: string
+        content:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        name:
+          type: string
+        function_call:
+          $ref: "#/components/schemas/FunctionCall"
+        tool_calls:
+          type: array
+          items:
+            $ref: "#/components/schemas/ToolCall"
+        tool_call_id:
+          type: string
+    ResponsesRequest:
+      type: object
+      properties:
+        model:
+          type: string
+        input:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        messages:
+          type: array
+          items:
+            $ref: "#/components/schemas/ResponseInputItem"
+        previous_response_id:
+          type: string
+        conversation:
+          type: object
+          additionalProperties: true
+        tools:
+          type: array
+          items:
+            oneOf:
+              - $ref: "#/components/schemas/ToolDefinition"
+              - $ref: "#/components/schemas/ResponseTool"
+        stream:
+          type: boolean
+        temperature:
+          type: number
+        max_output_tokens:
+          type: number
+        store:
+          type: boolean
+        instructions:
+          type: string
+        include:
+          type: array
+          items:
+            type: string
+        reasoning:
+          type: object
+          additionalProperties: true
+        parallel_tool_calls:
+          type: boolean
+        truncation:
+          type: string
+          enum:
+            - auto
+            - disabled
+        text:
+          type: object
+          additionalProperties: true
+        metadata:
+          type: object
+          additionalProperties:
+            type: string
+        prompt_cache_key:
+          type: string
+    ResponsesResult:
+      type: object
+      properties:
+        id:
+          type: string
+        object:
+          type: string
+          enum:
+            - response
+        created:
+          type: number
+        model:
+          type: string
+        status:
+          type: string
+          enum:
+            - completed
+            - failed
+            - in_progress
+            - queued
+            - cancelled
+            - incomplete
+        output:
+          type: array
+          items: {}
+        output_text:
+          type: string
+        usage:
+          type: object
+          additionalProperties: true
+        input_tokens:
+          type: number
+        output_tokens:
+          type: number
+        total_tokens:
+          type: number
+        error: {}
+        incomplete_details:
+          type: string
+          enum:
+            - max_output_tokens
+            - content_filter
+        previous_response_id:
+          type: string
+        conversation: {}
+        provider:
+          type: string
+          enum:
+            - openai
+        responseTime:
+          type: number
+      required:
+        - id
+        - object
+        - created
+        - model
+        - output
+        - output_text
+        - usage
+        - input_tokens
+        - output_tokens
+        - total_tokens
+        - provider
+        - responseTime
+    ResponsesStreamEvent:
+      type: object
+      properties:
+        type:
+          type: string
+      required:
+        - type
     ChatCompletionRequest:
       type: object
       properties:
@@ -9973,8 +10078,9 @@ components:
         id:
           type: string
         object:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - chat.completion
         created:
           type: number
         model:
@@ -10008,8 +10114,9 @@ components:
         id:
           type: string
         object:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - chat.completion.chunk
         created:
           type: number
         model:
@@ -10086,6 +10193,35 @@ components:
         - input
         - output
         - features
+    AIModelListParams:
+      type: object
+      properties:
+        provider:
+          type: string
+          enum:
+            - gemini
+            - openai
+        capability:
+          type: string
+          enum:
+            - text
+            - vision
+            - audio
+            - code
+    AIModelListResponse:
+      type: object
+      properties:
+        object:
+          type: string
+          enum:
+            - list
+        data:
+          type: array
+          items:
+            $ref: "#/components/schemas/AIModel"
+      required:
+        - object
+        - data
     DocumentChunk:
       type: object
       properties:
@@ -12040,8 +12176,9 @@ components:
           items:
             $ref: "#/components/schemas/AttestationSummaryBucket"
         audience:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - public
       required:
         - summary
         - audience
@@ -12086,8 +12223,9 @@ components:
           items:
             $ref: "#/components/schemas/AttestationSummaryBucket"
         audience:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - public
         subjectCount:
           type: number
       required:
@@ -12114,8 +12252,9 @@ components:
           items:
             $ref: "#/components/schemas/LatestAttestation"
         audience:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - public
         subjectCount:
           type: number
       required:
@@ -13952,8 +14091,9 @@ components:
           type: object
           additionalProperties: true
         type:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - object
         required:
           type: array
           items:
@@ -14425,8 +14565,9 @@ components:
       type: object
       properties:
         type:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - smartlinks-route-change
         path:
           type: string
         context:
@@ -14531,8 +14672,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - start
         id:
           type: string
         fields:
@@ -14563,8 +14705,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - chunk
         id:
           type: string
         seq:
@@ -14584,8 +14727,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - end
         id:
           type: string
       required:
@@ -14599,8 +14743,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - ack
         id:
           type: string
         seq:
@@ -14617,8 +14762,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - done
         id:
           type: string
         ok:
@@ -14673,8 +14819,9 @@ components:
         include:
           type: array
           items:
-            type: object
-            additionalProperties: true
+            type: string
+            enum:
+              - interaction
     AdminInteractionsCountsByOutcomeRequest:
       type: object
       properties:
@@ -15734,12 +15881,20 @@ components:
         - items
         - limit
         - offset
-    QueryOrdersRequest:
+    QueryOrderItemFilter:
+      type: object
+      properties:
+        productId:
+          type: string
+        batchId:
+          type: string
+        variantId:
+          type: string
+      required:
+        - productId
+    QueryOrdersFilter:
       type: object
       properties:
-        query:
-          type: object
-          additionalProperties: true
         status:
           type: string
         orderRef:
@@ -15761,6 +15916,8 @@ components:
         metadata:
           type: object
           additionalProperties: true
+        item:
+          $ref: "#/components/schemas/QueryOrderItemFilter"
         sortBy:
           type: string
         sortOrder:
@@ -15768,6 +15925,11 @@ components:
           enum:
             - asc
             - desc
+    QueryOrdersRequest:
+      type: object
+      properties:
+        query:
+          $ref: "#/components/schemas/QueryOrdersFilter"
         limit:
           type: number
         offset:
@@ -15955,9 +16117,7 @@ components:
         attribute:
           type: string
           enum:
-            - batchId
             - productId
-            - variantId
         value:
           type: string
       required:
@@ -16970,8 +17130,9 @@ components:
       type: object
       properties:
         engine:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - liquid
         source:
           type: string
         props: