@graphlit/durable-agents-sdk 1.0.20260610015-dev → 1.0.20260610017-dev

package/openapi/durable-agents.sdk.yaml

@@ -44,7 +44,7 @@ tags:
   - name: Channels
     description: Launch channel connectors, endpoints, inboxes, messaging phones, and bindings.
   - name: Billing
-    description: Usage and billing state. Purchases and top-up management are portal-only and are not exposed through public API-key auth.
+    description: Usage state and workspace wallet funding.
   - name: Audit
     description: Tenant audit events.
   - name: Webhooks
@@ -678,6 +678,26 @@ paths:
           $ref: "#/components/responses/DeletedResponse"
         default:
           $ref: "#/components/responses/ErrorResponse"
+  /api/durable/content/{content}/inspect:
+    get:
+      tags:
+        - Content
+      operationId: inspectContent
+      summary: Inspect content metadata and full rendered evidence.
+      description: Returns a content-ID addressed inspection payload modeled on MCP `inspect(contents://{id})`, including public content metadata, selected rendered text, sidecars, related content refs, provenance, and coverage.
+      security:
+        - apiKeyAuth: []
+      parameters:
+        - $ref: "#/components/parameters/ContentPath"
+      responses:
+        "200":
+          description: Content inspection.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ContentInspection"
+        default:
+          $ref: "#/components/responses/ErrorResponse"
   /api/durable/vfs/entries:
     get:
       tags:
@@ -823,6 +843,16 @@ paths:
           required: true
           schema:
             type: string
+        - name: search_type
+          in: query
+          required: false
+          description: Search mode. `keyword` uses Graphlit keyword search for `durable fs grep`; `hybrid` uses Graphlit hybrid semantic search for `durable fs sgrep`.
+          schema:
+            type: string
+            enum:
+              - keyword
+              - hybrid
+            default: keyword
         - name: ignore_case
           in: query
           required: false
@@ -1971,6 +2001,86 @@ paths:
                 $ref: "#/components/schemas/BillingUsage"
         default:
           $ref: "#/components/responses/ErrorResponse"
+  /api/durable/billing/funding-requests:
+    post:
+      tags:
+        - Billing
+      operationId: createBillingFundingRequest
+      summary: Create a wallet funding request for Link MPP payment.
+      security:
+        - apiKeyAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/BillingFundingRequestCreate"
+      responses:
+        "201":
+          description: Funding request created.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/BillingFundingRequest"
+        default:
+          $ref: "#/components/responses/ErrorResponse"
+  /api/durable/billing/funding-requests/{funding_request_id}:
+    get:
+      tags:
+        - Billing
+      operationId: getBillingFundingRequest
+      summary: Get a wallet funding request.
+      security:
+        - apiKeyAuth: []
+      parameters:
+        - $ref: "#/components/parameters/FundingRequestPath"
+      responses:
+        "200":
+          description: Funding request.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/BillingFundingRequest"
+        default:
+          $ref: "#/components/responses/ErrorResponse"
+  /api/durable/billing/funding-requests/{funding_request_id}/mpp:
+    post:
+      tags:
+        - Billing
+      operationId: completeBillingFundingMpp
+      summary: Complete a wallet funding request through MPP.
+      description: |
+        This endpoint is called by Link CLI `mpp pay`. Durable API-key bearer auth is
+        not used here; the `Authorization` header carries the MPP `Payment` credential.
+      security: []
+      parameters:
+        - $ref: "#/components/parameters/FundingRequestPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/BillingFundingMppComplete"
+      responses:
+        "200":
+          description: Funding request completed and wallet credited.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/BillingFundingCompletion"
+        "402":
+          description: Payment credential required. The MPP challenge is also returned in `WWW-Authenticate`.
+          headers:
+            WWW-Authenticate:
+              description: Serialized MPP `Payment` challenge.
+              schema:
+                type: string
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/BillingFundingRequest"
+        default:
+          $ref: "#/components/responses/ErrorResponse"
   /api/durable/audit:
     get:
       tags:
@@ -2045,6 +2155,12 @@ components:
       required: true
       schema:
         type: string
+    FundingRequestPath:
+      name: funding_request_id
+      in: path
+      required: true
+      schema:
+        type: string
     KeyPath:
       name: key
       in: path
@@ -2276,6 +2392,9 @@ components:
         - description
         - state
         - mode
+        - prompt
+        - focus
+        - trigger
         - persona
         - model
         - effort
@@ -2299,6 +2418,18 @@ components:
           $ref: "#/components/schemas/AgentMutableState"
         mode:
           $ref: "#/components/schemas/AgentMode"
+        prompt:
+          type:
+            - string
+            - "null"
+        focus:
+          type:
+            - string
+            - "null"
+        trigger:
+          anyOf:
+            - $ref: "#/components/schemas/AgentTrigger"
+            - type: "null"
         persona:
           anyOf:
             - $ref: "#/components/schemas/Ref"
@@ -2365,6 +2496,18 @@ components:
           anyOf:
             - $ref: "#/components/schemas/Effort"
             - type: "null"
+        prompt:
+          type:
+            - string
+            - "null"
+        focus:
+          type:
+            - string
+            - "null"
+        trigger:
+          anyOf:
+            - $ref: "#/components/schemas/AgentTrigger"
+            - type: "null"
         channels:
           type: array
           items:
@@ -2406,6 +2549,18 @@ components:
           anyOf:
             - $ref: "#/components/schemas/Effort"
             - type: "null"
+        prompt:
+          type:
+            - string
+            - "null"
+        focus:
+          type:
+            - string
+            - "null"
+        trigger:
+          anyOf:
+            - $ref: "#/components/schemas/AgentTrigger"
+            - type: "null"
         channels:
           type: array
           items:
@@ -2614,6 +2769,21 @@ components:
           type:
             - string
             - "null"
+    AgentTrigger:
+      type: object
+      additionalProperties: false
+      description: Content ingestion trigger. Empty object means any finished content.
+      properties:
+        kinds:
+          type: array
+          items:
+            type: string
+          description: Content or file kinds that should trigger the agent.
+        sources:
+          type: array
+          items:
+            $ref: "#/components/schemas/Ref"
+          description: Data source references that should trigger the agent.
     RunCreate:
       type: object
       additionalProperties: false
@@ -2684,6 +2854,9 @@ components:
         - output
         - error
         - usage
+        - current_execution_id
+        - terminal_execution_id
+        - latest_execution_id
         - started_at
         - completed_at
         - created_at
@@ -2713,6 +2886,18 @@ components:
           anyOf:
             - $ref: "#/components/schemas/UsageSummary"
             - type: "null"
+        current_execution_id:
+          type:
+            - string
+            - "null"
+        terminal_execution_id:
+          type:
+            - string
+            - "null"
+        latest_execution_id:
+          type:
+            - string
+            - "null"
         started_at:
           type:
             - string
@@ -3305,6 +3490,135 @@ components:
           items:
             type: string
           description: Replacement Graphlit collection GUIDs or unique names for the content.
+    ContentInspectionRef:
+      type: object
+      additionalProperties: false
+      required:
+        - uri
+      properties:
+        uri:
+          type: string
+          description: MCP content resource URI.
+          pattern: ^contents://.+
+        name:
+          type: string
+    ContentInspectionProvenance:
+      type: object
+      additionalProperties: false
+      required:
+        - source
+        - reused_existing_data
+      properties:
+        source:
+          type: string
+          enum:
+            - markdown
+            - summary
+            - description
+            - resource
+        reused_existing_data:
+          type: boolean
+    ContentInspectionCoverage:
+      type: object
+      additionalProperties: false
+      required:
+        - status
+        - source_kind
+        - full_text_available
+        - total_chars
+        - returned_chars
+        - truncation_reason
+      properties:
+        status:
+          type: string
+          enum:
+            - full
+            - partial
+            - preview
+            - truncated
+        source_kind:
+          type: string
+          enum:
+            - inline_markdown
+            - stored_summary
+            - stored_description
+            - resource_name
+        full_text_available:
+          type: boolean
+        total_chars:
+          type: integer
+          minimum: 0
+        returned_chars:
+          type: integer
+          minimum: 0
+        truncation_reason:
+          type:
+            - string
+            - "null"
+    ContentInspection:
+      type: object
+      additionalProperties: false
+      required:
+        - uri
+        - resource_type
+        - content
+        - name
+        - mime_type
+        - text
+        - summary
+        - markdown
+        - description
+        - metadata
+        - parent
+        - children
+        - provenance
+        - coverage
+      properties:
+        uri:
+          type: string
+          pattern: ^contents://.+
+        resource_type:
+          type: string
+          enum:
+            - content
+        content:
+          $ref: "#/components/schemas/Content"
+        name:
+          type: string
+        mime_type:
+          type:
+            - string
+            - "null"
+        text:
+          type: string
+          description: Selected rendered text for terminal inspection. This field is not locally truncated by the Durable CLI/API.
+        summary:
+          type:
+            - string
+            - "null"
+        markdown:
+          type:
+            - string
+            - "null"
+        description:
+          type:
+            - string
+            - "null"
+        metadata:
+          type: object
+          additionalProperties: true
+        parent:
+          anyOf:
+            - $ref: "#/components/schemas/ContentInspectionRef"
+            - type: "null"
+        children:
+          type: array
+          items:
+            $ref: "#/components/schemas/ContentInspectionRef"
+        provenance:
+          $ref: "#/components/schemas/ContentInspectionProvenance"
+        coverage:
+          $ref: "#/components/schemas/ContentInspectionCoverage"
     VfsEntry:
       type: object
       additionalProperties: false
@@ -4944,6 +5258,320 @@ components:
           type: string
         code:
           type: string
+    BillingFundingStatus:
+      type: string
+      enum:
+        - payment_required
+        - processing
+        - succeeded
+        - failed
+        - expired
+        - cancelled
+    BillingFundingRequestCreate:
+      type: object
+      additionalProperties: false
+      required:
+        - credits
+        - payment_method
+      properties:
+        credits:
+          type: number
+          minimum: 1
+          maximum: 50000
+        payment_method:
+          type: string
+          const: link_mpp
+    BillingFundingMerchant:
+      type: object
+      additionalProperties: false
+      required:
+        - name
+        - url
+      properties:
+        name:
+          type: string
+        url:
+          type: string
+          format: uri
+    BillingFundingLineItem:
+      type: object
+      additionalProperties: false
+      required:
+        - name
+        - unit_amount
+        - quantity
+        - description
+      properties:
+        name:
+          type: string
+        unit_amount:
+          type: integer
+        quantity:
+          type: integer
+        description:
+          type: string
+    BillingFundingTotal:
+      type: object
+      additionalProperties: false
+      required:
+        - type
+        - display_text
+        - amount
+      properties:
+        type:
+          type: string
+          const: total
+        display_text:
+          type: string
+        amount:
+          type: integer
+    BillingFundingMpp:
+      type: object
+      additionalProperties: false
+      required:
+        - url
+        - method
+        - body
+        - network_id
+        - challenge
+        - debug_decode_command
+        - pay_command
+      properties:
+        url:
+          type: string
+          format: uri
+        method:
+          type: string
+          const: POST
+        body:
+          type: object
+          additionalProperties: false
+          required:
+            - funding_request_id
+          properties:
+            funding_request_id:
+              type: string
+        network_id:
+          type: string
+        challenge:
+          type: string
+        debug_decode_command:
+          type: string
+        pay_command:
+          type: string
+    BillingFundingLinkCli:
+      type: object
+      additionalProperties: false
+      required:
+        - spend_request_create
+        - mpp_pay
+      properties:
+        spend_request_create:
+          type: object
+          additionalProperties: false
+          required:
+            - payment_method_id_required
+            - args_without_payment_method
+          properties:
+            payment_method_id_required:
+              type: boolean
+              const: true
+            args_without_payment_method:
+              type: array
+              items:
+                type: string
+        mpp_pay:
+          type: object
+          additionalProperties: false
+          required:
+            - spend_request_id_required
+            - args_without_spend_request_id
+          properties:
+            spend_request_id_required:
+              type: boolean
+              const: true
+            args_without_spend_request_id:
+              type: array
+              items:
+                type: string
+    BillingFundingLinkMcp:
+      type: object
+      additionalProperties: false
+      required:
+        - spend_request_create_input_without_payment_method
+        - mpp_pay_input_without_spend_request_id
+      properties:
+        spend_request_create_input_without_payment_method:
+          type: object
+          additionalProperties: false
+          required:
+            - credentialType
+            - networkId
+            - context
+            - amount
+            - currency
+            - lineItem
+            - total
+            - requestApproval
+          properties:
+            credentialType:
+              type: string
+              const: shared_payment_token
+            networkId:
+              type: string
+            context:
+              type: string
+            amount:
+              type: integer
+            currency:
+              type: string
+              const: usd
+            lineItem:
+              type: array
+              items:
+                $ref: "#/components/schemas/BillingFundingLineItem"
+            total:
+              type: array
+              items:
+                $ref: "#/components/schemas/BillingFundingTotal"
+            requestApproval:
+              type: boolean
+              const: true
+        mpp_pay_input_without_spend_request_id:
+          type: object
+          additionalProperties: false
+          required:
+            - url
+            - method
+            - data
+          properties:
+            url:
+              type: string
+              format: uri
+            method:
+              type: string
+              const: POST
+            data:
+              type: string
+    BillingFundingProviderResult:
+      type: object
+      additionalProperties: false
+      required:
+        - kind
+        - payment_intent_id
+        - charge_id
+      properties:
+        kind:
+          type: string
+          const: stripe
+        payment_intent_id:
+          type:
+            - string
+            - "null"
+        charge_id:
+          type:
+            - string
+            - "null"
+    BillingFundingRequest:
+      type: object
+      additionalProperties: false
+      required:
+        - id
+        - status
+        - credits
+        - amount_cents
+        - currency
+        - merchant
+        - line_items
+        - totals
+        - context
+        - mpp
+        - link_cli
+        - link_mcp
+        - provider_result
+        - failure_code
+        - failure_message
+        - created_at
+        - expires_at
+        - completed_at
+        - updated_at
+      properties:
+        id:
+          type: string
+        status:
+          $ref: "#/components/schemas/BillingFundingStatus"
+        credits:
+          type: number
+        amount_cents:
+          type: integer
+        currency:
+          type: string
+          const: usd
+        merchant:
+          $ref: "#/components/schemas/BillingFundingMerchant"
+        line_items:
+          type: array
+          items:
+            $ref: "#/components/schemas/BillingFundingLineItem"
+        totals:
+          type: array
+          items:
+            $ref: "#/components/schemas/BillingFundingTotal"
+        context:
+          type: string
+        mpp:
+          $ref: "#/components/schemas/BillingFundingMpp"
+        link_cli:
+          $ref: "#/components/schemas/BillingFundingLinkCli"
+        link_mcp:
+          $ref: "#/components/schemas/BillingFundingLinkMcp"
+        provider_result:
+          anyOf:
+            - $ref: "#/components/schemas/BillingFundingProviderResult"
+            - type: "null"
+        failure_code:
+          type:
+            - string
+            - "null"
+        failure_message:
+          type:
+            - string
+            - "null"
+        created_at:
+          type: string
+          format: date-time
+        expires_at:
+          type: string
+          format: date-time
+        completed_at:
+          type:
+            - string
+            - "null"
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+    BillingFundingMppComplete:
+      type: object
+      additionalProperties: false
+      required:
+        - funding_request_id
+      properties:
+        funding_request_id:
+          type: string
+    BillingFundingCompletion:
+      type: object
+      additionalProperties: false
+      required:
+        - funding_request
+        - usage
+      properties:
+        funding_request:
+          $ref: "#/components/schemas/BillingFundingRequest"
+        usage:
+          anyOf:
+            - $ref: "#/components/schemas/BillingUsage"
+            - type: "null"
     BillingUsage:
       type: object
       additionalProperties: false