naftiko: 1.0.0-alpha2
info:
  label: Assembled Agent State API — State
  description: 'Assembled Agent State API — State. Real-time and historical agent state plus platform-ID associations.'
  tags:
    - Assembled
    - Agent State
    - Real-Time
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
  - namespace: env
    keys:
      ASSEMBLED_API_KEY: ASSEMBLED_API_KEY
capability:
  consumes:
    - type: http
      namespace: agent-state-state
      baseUri: https://api.assembledhq.com
      description: Assembled Agent State business capability.
      resources:
        - name: v0-agents-state
          path: /v0/agents/state
          operations:
            - name: getagentstates
              method: GET
              description: Assembled Get Agent States
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
        - name: v0-agents-state-bulk
          path: /v0/agents/state/bulk
          operations:
            - name: bulkupdateagentstates
              method: POST
              description: Assembled Bulk Update Agent States
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
        - name: v0-agents-state-condensed-timeline
          path: /v0/agents/state/condensed_timeline
          operations:
            - name: getcondensedtimeline
              method: GET
              description: Assembled Get Condensed Agent State Timeline
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
        - name: v0-agents-state-edit
          path: /v0/agents/state/edit
          operations:
            - name: editagentstate
              method: POST
              description: Assembled Edit Agent State
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
        - name: v0-agents-state-edit-history
          path: /v0/agents/state/edit/history
          operations:
            - name: geteditstatehistory
              method: GET
              description: Assembled Get Agent State Edit History
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
        - name: v0-agents-associations
          path: /v0/agents/associations
          operations:
            - name: createassociations
              method: POST
              description: Assembled Create Agent Associations
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
      authentication:
        type: basic
        username: '{{env.ASSEMBLED_API_KEY}}'
        password: ''
  exposes:
    - type: mcp
      namespace: agent-state-state-mcp
      port: 9090
      transport: http
      description: MCP adapter for Assembled Agent State.
      tools:
        - name: assembled-get-agent-states
          description: Assembled Get Agent States
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: agent-state-state.getagentstates
          outputParameters: [{ type: object, mapping: $. }]
        - name: assembled-bulk-update-agent-states
          description: Assembled Bulk Update Agent States
          hints: { readOnly: false, destructive: false, idempotent: false }
          call: agent-state-state.bulkupdateagentstates
          outputParameters: [{ type: object, mapping: $. }]
        - name: assembled-get-condensed-timeline
          description: Assembled Get Condensed Agent State Timeline
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: agent-state-state.getcondensedtimeline
          outputParameters: [{ type: object, mapping: $. }]
        - name: assembled-edit-agent-state
          description: Assembled Edit Agent State
          hints: { readOnly: false, destructive: true, idempotent: false }
          call: agent-state-state.editagentstate
          outputParameters: [{ type: object, mapping: $. }]
        - name: assembled-get-edit-state-history
          description: Assembled Get Agent State Edit History
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: agent-state-state.geteditstatehistory
          outputParameters: [{ type: object, mapping: $. }]
        - name: assembled-create-agent-associations
          description: Assembled Create Agent Associations
          hints: { readOnly: false, destructive: false, idempotent: false }
          call: agent-state-state.createassociations
          outputParameters: [{ type: object, mapping: $. }]