@proveanything/smartlinks 2.0.25 → 2.0.28

package/openapi.yaml

@@ -16,6 +16,8 @@ tags:
     description: Chat completion generation.
   - name: agent
     description: Agent orchestration and tool-calling.
+  - name: tools
+    description: tools API
   - name: skills
     description: Reusable agent skills.
   - name: models
@@ -1239,6 +1241,45 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/ai/tools/{name}/run:
+    post:
+      tags:
+        - tools
+      summary: tools.run
+      operationId: tools_run
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: name
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ToolRunResult"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              additionalProperties: true
   /admin/collection/{collectionId}/ai/tts:
     post:
       tags:
@@ -10390,6 +10431,38 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /public/collection/{collectionId}/ai/agent/run:
+    post:
+      tags:
+        - publicClient
+      summary: Public agent loop — run the orchestration-neutral tool loop on the consumer surface.
+      operationId: publicClient_agentRun
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AgentRunResult"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PublicAgentRunRequest"
   /public/collection/{collectionId}/ai/chat:
     post:
       tags:
@@ -15499,6 +15572,10 @@ components:
             $ref: "#/components/schemas/AiToolName"
         maxSteps:
           type: number
+        app_functions:
+          $ref: "#/components/schemas/AgentAppFunctionsOption"
+        toolbelt:
+          $ref: "#/components/schemas/AgentToolbelt"
       required:
         - enabled
     ResponsesResult:
@@ -16530,6 +16607,162 @@ components:
           type: array
           items:
             type: string
+        appFunctions:
+          $ref: "#/components/schemas/AgentAppFunctionsOption"
+        toolbelt:
+          $ref: "#/components/schemas/AgentToolbelt"
+    AgentAppFunctionsOption:
+      type: object
+      properties:
+        appId:
+          type: string
+        channel:
+          type: string
+        only:
+          type: array
+          items:
+            type: string
+      required:
+        - appId
+    AgentToolbelt:
+      type: object
+      properties:
+        builtins:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        appFunctions:
+          type: array
+          items:
+            $ref: "#/components/schemas/AgentAppFunctionsOption"
+        clientTools:
+          type: array
+          items:
+            $ref: "#/components/schemas/ClientToolDeclaration"
+    ClientToolDeclaration:
+      type: object
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        input:
+          type: object
+          additionalProperties: true
+      required:
+        - name
+    ClientToolCall:
+      type: object
+      properties:
+        callId:
+          type: string
+        name:
+          type: string
+        args:
+          type: object
+          additionalProperties: true
+      required:
+        - callId
+        - name
+        - args
+    RequiresActionResult:
+      type: object
+      properties:
+        status:
+          type: string
+          enum:
+            - requires_action
+        client_tool_calls:
+          type: array
+          items:
+            $ref: "#/components/schemas/ClientToolCall"
+        items:
+          type: array
+          items: {}
+        steps:
+          type: number
+        toolResults:
+          type: array
+          items:
+            $ref: "#/components/schemas/AgentToolResult"
+        availableTools:
+          type: array
+          items:
+            type: string
+      required:
+        - status
+        - client_tool_calls
+        - items
+    ClientTool:
+      type: object
+      properties:
+        declaration:
+          $ref: "#/components/schemas/ClientToolDeclaration"
+      required:
+        - declaration
+    RunWithClientToolsOptions:
+      type: object
+      properties:
+        input:
+          type: string
+        tools:
+          type: array
+          items:
+            $ref: "#/components/schemas/ClientTool"
+        surface:
+          type: string
+          enum:
+            - admin
+            - public
+        instructions:
+          type: string
+        model:
+          type: string
+        maxSteps:
+          type: number
+        toolbelt:
+          $ref: "#/components/schemas/AgentToolbelt"
+        maxRounds:
+          type: number
+      required:
+        - input
+        - tools
+    PublicAgentRunRequest:
+      type: object
+      properties:
+        input:
+          type: string
+        prompt:
+          type: string
+        instructions:
+          type: string
+        model:
+          type: string
+        maxSteps:
+          type: number
+        server_tools:
+          type: array
+          items:
+            $ref: "#/components/schemas/AiToolName"
+        only:
+          type: array
+          items:
+            $ref: "#/components/schemas/AiToolName"
+        exclude:
+          type: array
+          items:
+            $ref: "#/components/schemas/AiToolName"
+        allowCapabilities:
+          type: array
+          items:
+            $ref: "#/components/schemas/AiToolCapability"
+        appFunctions:
+          $ref: "#/components/schemas/AgentAppFunctionsOption"
+        toolbelt:
+          $ref: "#/components/schemas/AgentToolbelt"
+        userId:
+          type: string
     AgentToolResult:
       type: object
       properties:
@@ -16542,6 +16775,20 @@ components:
         - name
         - isError
         - result
+    ToolRunResult:
+      type: object
+      properties:
+        name:
+          type: string
+        isError:
+          type: boolean
+        result:
+          type: object
+          additionalProperties: true
+      required:
+        - name
+        - isError
+        - result
     AgentRunResult:
       type: object
       properties:
@@ -16793,6 +17040,30 @@ components:
             type: string
       required:
         - urls
+    PdfInspectArgs:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
+    PdfRenderArgs:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
+    PdfExtractArgs:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
     HttpRequestArgs:
       type: object
       properties:
@@ -16848,6 +17119,12 @@ components:
           $ref: "#/components/schemas/PdfFillArgs"
         pdf.merge:
           $ref: "#/components/schemas/PdfMergeArgs"
+        pdf.inspect:
+          $ref: "#/components/schemas/PdfInspectArgs"
+        pdf.render:
+          $ref: "#/components/schemas/PdfRenderArgs"
+        pdf.extract:
+          $ref: "#/components/schemas/PdfExtractArgs"
         http.request:
           $ref: "#/components/schemas/HttpRequestArgs"
         translate:
@@ -16868,6 +17145,9 @@ components:
         - pdf.create
         - pdf.fill
         - pdf.merge
+        - pdf.inspect
+        - pdf.render
+        - pdf.extract
         - http.request
         - translate
     WebSearchResultItem:
@@ -16944,6 +17224,48 @@ components:
           additionalProperties: true
       required:
         - translations
+    PdfInspectPage:
+      type: object
+      properties:
+        page:
+          type: string
+          enum:
+            - text-native
+            - text+raster
+            - raster-only
+            - curve-only
+      required:
+        - page
+    PdfInspectResult:
+      type: object
+      properties:
+        url:
+          type: array
+          items:
+            type: string
+            enum:
+              - text
+              - vision
+      required:
+        - url
+    PdfRenderResult:
+      type: object
+      properties:
+        url:
+          type: object
+          additionalProperties: true
+      required:
+        - url
+    PdfExtractResult:
+      type: object
+      properties:
+        url:
+          type: string
+          enum:
+            - text
+            - vision
+      required:
+        - url
     ResponsesAgentTrace:
       type: object
       properties:
@@ -17022,6 +17344,9 @@ components:
         - pdf.create
         - pdf.fill
         - pdf.merge
+        - pdf.inspect
+        - pdf.render
+        - pdf.extract
         - http.request
         - translate
     AgentStreamEvent:
@@ -18264,9 +18589,30 @@ components:
           type: string
         handler:
           type: string
+        agent:
+          $ref: "#/components/schemas/AppFunctionAgentExposure"
       required:
         - name
         - trigger
+    AppFunctionAgentExposure:
+      type: object
+      properties:
+        tool:
+          type: boolean
+        title:
+          type: string
+        description:
+          type: string
+        input:
+          type: object
+          additionalProperties: true
+        approval:
+          type: string
+          enum:
+            - auto
+            - require
+      required:
+        - tool
     AppManifestFunctions:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "2.0.25",
+  "version": "2.0.28",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",