@proveanything/smartlinks 1.16.7 → 1.17.4

package/dist/openapi.yaml

@@ -9,6 +9,8 @@ servers:
 tags:
   - name: responses
   - name: completions
+  - name: agent
+  - name: skills
   - name: models
   - name: rag
   - name: sessions
@@ -50,6 +52,7 @@ tags:
   - name: proof
   - name: qr
   - name: realtime
+  - name: research
   - name: segments
   - name: tags
   - name: template
@@ -619,6 +622,108 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/ai/agent/run:
+    post:
+      tags:
+        - agent
+      summary: "Run the server-side AI agent loop once: assembles the tool set, runs the model, executes tool calls, and returns the final text + the tool trace."
+      operationId: agent_run
+      security:
+        - bearerAuth: []
+      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/AgentRunRequest"
+  /admin/collection/{collectionId}/ai/agent/tools:
+    get:
+      tags:
+        - agent
+      summary: List the tools the agent can use (optionally scoped by capability / name).
+      operationId: agent_listTools
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: allowCapabilities
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: only
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: exclude
+          in: query
+          required: false
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AgentToolsResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/collection/{collectionId}/ai/catalog:
+    get:
+      tags:
+        - skills
+      summary: The full self-describing catalog (tools + skills).
+      operationId: skills_catalog
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CatalogResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/ai/configureAssistant:
     post:
       tags:
@@ -947,6 +1052,33 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/ai/skills:
+    get:
+      tags:
+        - skills
+      summary: List the skills apps can invoke (name, description, input/output schema).
+      operationId: skills_list
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SkillsListResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/ai/tts:
     post:
       tags:
@@ -7404,6 +7536,39 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/research/fetch:
+    post:
+      tags:
+        - research
+      summary: "Fetch + extract a web page: clean markdown, page metadata, and any schema.org JSON-LD (filtered by `type` when given)."
+      operationId: research_fetch
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ResearchFetchResult"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ResearchFetchRequest"
   /admin/collection/{collectionId}/segments:
     get:
       tags:
@@ -15814,6 +15979,143 @@ components:
           type: string
       required:
         - url
+    AgentRunRequest:
+      type: object
+      properties:
+        input:
+          type: string
+        prompt:
+          type: string
+        instructions:
+          type: string
+        model:
+          type: string
+        maxSteps:
+          type: number
+        allowCapabilities:
+          type: array
+          items:
+            type: string
+        only:
+          type: array
+          items:
+            type: string
+        exclude:
+          type: array
+          items:
+            type: string
+    AgentToolResult:
+      type: object
+      properties:
+        name:
+          type: string
+        isError:
+          type: boolean
+        result: {}
+      required:
+        - name
+        - isError
+        - result
+    AgentRunResult:
+      type: object
+      properties:
+        finalText:
+          type: string
+        steps:
+          type: number
+        maxStepsReached:
+          type: boolean
+        toolResults:
+          type: array
+          items:
+            $ref: "#/components/schemas/AgentToolResult"
+        availableTools:
+          type: array
+          items:
+            type: string
+      required:
+        - finalText
+        - steps
+        - maxStepsReached
+        - toolResults
+        - availableTools
+    AgentToolDefinition:
+      type: object
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        capabilities:
+          type: array
+          items:
+            type: string
+        parameters: {}
+      required:
+        - name
+        - description
+        - capabilities
+        - parameters
+    AgentToolsResponse:
+      type: object
+      properties:
+        tools:
+          type: array
+          items:
+            $ref: "#/components/schemas/AgentToolDefinition"
+      required:
+        - tools
+    AgentToolsQuery:
+      type: object
+      properties:
+        allowCapabilities:
+          type: string
+        only:
+          type: string
+        exclude:
+          type: string
+    SkillDescriptor:
+      type: object
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        inputSchema: {}
+        outputSchema: {}
+        capabilities:
+          type: array
+          items:
+            type: string
+      required:
+        - name
+        - description
+        - inputSchema
+        - outputSchema
+        - capabilities
+    SkillsListResponse:
+      type: object
+      properties:
+        skills:
+          type: array
+          items:
+            $ref: "#/components/schemas/SkillDescriptor"
+      required:
+        - skills
+    CatalogResponse:
+      type: object
+      properties:
+        tools:
+          type: array
+          items:
+            $ref: "#/components/schemas/AgentToolDefinition"
+        skills:
+          type: array
+          items:
+            $ref: "#/components/schemas/SkillDescriptor"
+      required:
+        - tools
+        - skills
     AnalyticsLocation:
       type: object
       properties:
@@ -22860,6 +23162,276 @@ components:
     UploadMessage:
       type: object
       additionalProperties: true
+    FieldMapping:
+      type: object
+      properties:
+        targetPath:
+          type: string
+        sourcePath:
+          type: string
+        transformType:
+          $ref: "#/components/schemas/TransformType"
+        transformExpression:
+          type: string
+      required:
+        - targetPath
+        - transformType
+    FlowConnectionAuth:
+      type: object
+      properties:
+        method:
+          $ref: "#/components/schemas/FlowAuthMethod"
+        headerName:
+          type: string
+        credentialRef:
+          type: string
+      required:
+        - method
+    FlowConnection:
+      type: object
+      properties:
+        baseUrl:
+          type: string
+        sendEndpoint:
+          type: string
+        fetchEndpoint:
+          type: string
+        defaultHeaders:
+          type: object
+          additionalProperties:
+            type: string
+        auth:
+          $ref: "#/components/schemas/FlowConnectionAuth"
+    IntegrationFlowConfig:
+      type: object
+      properties:
+        connection:
+          $ref: "#/components/schemas/FlowConnection"
+        fieldMappings:
+          type: array
+          items:
+            $ref: "#/components/schemas/FieldMapping"
+    IntegrationFlow:
+      type: object
+      properties:
+        id:
+          type: string
+        orgId:
+          type: string
+        collectionId:
+          type: string
+        appId:
+          type: string
+        direction:
+          $ref: "#/components/schemas/FlowDirection"
+        name:
+          type: string
+        status:
+          $ref: "#/components/schemas/FlowStatus"
+        eventTypes:
+          type: array
+          items:
+            type: string
+        schedule:
+          type: string
+        sourceEntity:
+          type: string
+        targetEntity:
+          type: string
+        config:
+          $ref: "#/components/schemas/IntegrationFlowConfig"
+        createdBy:
+          type: string
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+        deletedAt:
+          type: string
+        lastRunAt:
+          type: string
+        lastRunStatus:
+          type: string
+        lastRunError:
+          type: string
+        lastRunCount:
+          type: number
+        lastPollAt:
+          type: string
+        lastCursor:
+          type: string
+        totalSynced:
+          type: number
+      required:
+        - id
+        - orgId
+        - collectionId
+        - appId
+        - direction
+        - name
+        - status
+        - eventTypes
+        - schedule
+        - sourceEntity
+        - targetEntity
+        - config
+        - createdBy
+        - createdAt
+        - updatedAt
+    CreateFlowInput:
+      type: object
+      properties:
+        appId:
+          type: string
+        direction:
+          $ref: "#/components/schemas/FlowDirection"
+        name:
+          type: string
+        status:
+          $ref: "#/components/schemas/FlowStatus"
+        eventTypes:
+          type: array
+          items:
+            type: string
+        schedule:
+          type: string
+        sourceEntity:
+          type: string
+        targetEntity:
+          type: string
+        config:
+          $ref: "#/components/schemas/IntegrationFlowConfig"
+      required:
+        - appId
+        - direction
+        - name
+    ListFlowsQuery:
+      type: object
+      properties:
+        direction:
+          $ref: "#/components/schemas/FlowDirection"
+        status:
+          $ref: "#/components/schemas/FlowStatus"
+        appId:
+          type: string
+    FlowList:
+      type: object
+      properties:
+        flows:
+          type: array
+          items:
+            $ref: "#/components/schemas/IntegrationFlow"
+      required:
+        - flows
+    RunFlowInput:
+      type: object
+      properties:
+        entityId:
+          type: string
+    RunFlowSummary:
+      type: object
+      properties:
+        flowId:
+          type: string
+        direction:
+          $ref: "#/components/schemas/FlowDirection"
+        records:
+          type: number
+        sent:
+          type: number
+        failed:
+          type: number
+        status:
+          $ref: "#/components/schemas/RunStatus"
+      required:
+        - flowId
+        - direction
+        - records
+        - sent
+        - failed
+        - status
+    RunFlowEnqueued:
+      type: object
+      properties:
+        enqueued:
+          type: object
+          additionalProperties: true
+        flowId:
+          type: string
+        entityId:
+          type: string
+      required:
+        - enqueued
+        - flowId
+        - entityId
+    SecretMeta:
+      type: object
+      properties:
+        ref:
+          type: string
+        name:
+          type: string
+        purpose:
+          type: string
+        hint:
+          type: string
+        keyVersion:
+          type: number
+        createdBy:
+          type: string
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+        rotatedAt:
+          type: string
+      required:
+        - ref
+        - name
+        - purpose
+        - hint
+        - keyVersion
+        - createdBy
+        - createdAt
+        - updatedAt
+    SecretList:
+      type: object
+      properties:
+        secrets:
+          type: array
+          items:
+            $ref: "#/components/schemas/SecretMeta"
+      required:
+        - secrets
+    SetSecretInput:
+      type: object
+      properties:
+        value:
+          type: string
+        name:
+          type: string
+        purpose:
+          type: string
+      required:
+        - value
+    SetSecretResult:
+      type: object
+      properties:
+        ref:
+          type: string
+        hint:
+          type: string
+      required:
+        - ref
+        - hint
+    ListSecretsQuery:
+      type: object
+      properties:
+        purpose:
+          type: string
+    RunFlowResult:
+      type: object
+      additionalProperties: true
     AdminInteractionsQueryRequest:
       type: object
       properties:
@@ -26129,6 +26701,51 @@ components:
         - nonce
         - mac
         - clientId
+    ResearchFetchRequest:
+      type: object
+      properties:
+        url:
+          type: string
+        type:
+          type: string
+        schemaType:
+          type: string
+        forceRefresh:
+          type: boolean
+      required:
+        - url
+    ResearchFetchResult:
+      type: object
+      properties:
+        provider:
+          type: string
+          enum:
+            - firecrawl
+            - web
+        status:
+          type: number
+        markdown:
+          type: string
+        html:
+          type: string
+        metadata:
+          type: object
+          additionalProperties: true
+        schemas:
+          type: array
+          items: {}
+        url:
+          type: string
+        cached:
+          type: boolean
+        fetchedAt:
+          type: string
+      required:
+        - provider
+        - status
+        - schemas
+        - url
+        - cached
     InteractionFilterValue:
       type: object
       properties:

package/dist/types/ai.d.ts

@@ -479,3 +479,60 @@ export interface AISearchPhotosPhoto {
     /** Allow extra fields */
     [key: string]: any;
 }
+export interface AgentRunRequest {
+    /** User prompt (either input or prompt). */
+    input?: string;
+    prompt?: string;
+    /** System instructions. */
+    instructions?: string;
+    /** Model id, e.g. 'openai/gpt-5.6-terra'. */
+    model?: string;
+    /** Safety cap on model round-trips. */
+    maxSteps?: number;
+    /** Cap blast radius: only tools whose capabilities are all granted. */
+    allowCapabilities?: string[];
+    /** Restrict to these tool names. */
+    only?: string[];
+    /** Drop these tool names. */
+    exclude?: string[];
+}
+export interface AgentToolResult {
+    name: string;
+    isError: boolean;
+    result: any;
+}
+export interface AgentRunResult {
+    finalText: string | null;
+    steps: number;
+    maxStepsReached: boolean;
+    toolResults: AgentToolResult[];
+    availableTools: string[];
+}
+export interface AgentToolDefinition {
+    name: string;
+    description: string;
+    capabilities: string[];
+    parameters: any;
+}
+export interface AgentToolsResponse {
+    tools: AgentToolDefinition[];
+}
+export interface AgentToolsQuery {
+    allowCapabilities?: string;
+    only?: string;
+    exclude?: string;
+}
+export interface SkillDescriptor {
+    name: string;
+    description: string;
+    inputSchema: any;
+    outputSchema: any;
+    capabilities: string[];
+}
+export interface SkillsListResponse {
+    skills: SkillDescriptor[];
+}
+export interface CatalogResponse {
+    tools: AgentToolDefinition[];
+    skills: SkillDescriptor[];
+}